Copyright: ODBC Microsoft Desktop Database Drivers Ohje


SQL92-yhteensopivuus (laajennettu kielioppi)

ODBC Desktop Database -ohjaimet ja niiden pohjana oleva Microsoft Jet -tietokantamoduuli eivät ole SQL92-yhteensopivia. Ne tukevat monia toimintoja, jotka on määritetty SQL92:ssa. Eräät ohjaimessa tuetut ominaisuudet eivät ole tuettuja SQL92:ssa. Lisätietoja on julkaisussa Microsoft Jet Database Engine Programmer's Guide. Seuraavassa on luettelo pääasiallisista eroista:

•	Desktop Database -ohjainten käyttämä SQL tukee tehokkaampia lausekkeita kuin SQL92.

•	BETWEEN-predikaattiin sovelletaan erilaisia sääntöjä.

•	Desktop Database -ohjainten käyttämä SQL  ANSI SQLin tukevat avainsanoja.

Microsoft Jet SQL ei tue seuraavia SQL92-toimintoja:

•	Suojalausekkeita, esimerkiksi GRANT ja LOCK.

•	DISTINCT-predikaattia, jossa on koostetoimintoviittauksia.

Seuraavat toiminnot ovat Desktop Database -ohjaimien käyttämiä SQL:n parannuksia, joita ei ole määritetty SQL92:ssa:

•	Ristiintaulukointikyselyjä tukeva TRANSFORM-lause.

•	Lisäkoostefunktiot (StDev ja VarP).


Tuettu ODBC SQL -lisäkielioppi (laajennettu kielioppi)

ODBC-ohjaimet tukevat ODBC:n version 2.5 koko vähimmäiskielioppia ja alla lueteltuja ydinkieliopin ja jatketun kieliopin lauseita. Saat lisätietoja siirtymällä ALTER TABLE -lauseeseen, korrelaationimiin ja toimintosarjakutsuihin liittyviin ohjeaiheisiin.

•	likiarvoliteraali (ydinkielioppi)

•	ALTER TABLE -lause (ydinkielioppi)

•	Binaariliteraalit (laajennettu kielioppi)

•	BETWEEN-predikaatti (ydinkielioppi)

•	Korrelaationimet (ydinkielioppi)

•	EXISTS-predikaatti (ydinkielioppi)

•	IN (arvoluettelo) (ydinkielioppi)

•	Ulkoliitokset (laajennettu kielioppi)

•	Toimintosarjakutsu (laajennettu kielioppi)

•	SELECT-lause (laajennettu kielioppi) (mukaan luettuna GROUP BY -, HAVING-  ja UNION-lauseenosat)

•	Alikyselyt (SUBSELECTs-kyselyt) (ydinkielioppi)

•	Aihe


ALTER TABLE -lause (ydinkielioppi)

Katso myös

Käytettäessä Microsoft Access-, dBASE- tai Paradox-ohjainta ALTER TABLE -lauseessa tuetaan ADD CONSTRAINT- ja DROP CONSTRAINT -lauseenosia. (Microsoft Excel- ja Teksti-ohjain eivät tue ALTER TABLE -lauseita.)

Huomautus   Kun käytät Paradox-ohjainta mutta et Borland Database Engine -moduulia, ALTER TABLE -lauseet eivät ole tuettuja; vain APPEND-lauseet ja lukutilan-lauseet ovat sallittuja.


Korrelaationimet (ydinkielioppi)

Korrelaationimet ovat täysin tuettuja, myös taulukkoluettelossa. Esimerkiksi seuraavassa merkkijonossa  E1 on Henk-nimisen taulukon korrelaationimi.

SELECT * FROM Henk E1
WHERE E1.LastName = 'Virtanen'


Toimintosarjan kutsu (laajennettu kielioppi)

Microsoft Access -ohjainta käytettäessä ohjaimen toimintosarjoja voidaan kutsua käyttämällä SQLExecDirect- tai SQLPrepare-funktiota seuraavan syntaksin kanssa: {CALL toimintosarjan-nimi [(parametri[,parametri]...)]}. Ota huomioon, että ohjain ei tue lausekkeita kutsutun toimintosarjan parametreina.

Jos toimintosarjan nimessä on yhdysviiva, nimi on erotettava gravisaksenteilla (`).

Parametroitu kysely voidaan kutsua käyttämällä edellistä lausetta.


BETWEEN-predikaatti

Syntaksi

lauseke1 BETWEEN lauseke2 AND lauseke3

Palauttaa arvon TRUE vain, jos lauseke1 on suurempi tai yhtä suuri kuin lauseke2 ja lauseke1 on pienempi tai yhtä suuri kuin lauseke3.

Tämä predikaatti toimii eri tavalla Desktop Database -ohjaimissa ja Microsoft Jet -moduulissa. Microsoft Jet SQL:ssä lauseke2 voi olla suurempi kuin lauseke3, jolloin lause palauttaa arvon TRUE vain, jos lauseke1 on suurempi tai yhtä suuri kuin lauseke3 ja lauseke1 on pienempi tai yhtä suuri kuin lauseke2.


CREATE INDEX -lause

Katso myös

CREATE INDEX -lauseen syntaksi on:

CREATE [UNIQUE] INDEX indeksin nimi ON taulukon nimi (saraketunnus [ASC][DESC][, saraketunnus [ASC][DESC]...]) WITH <indeksivaihtoehtoluettelo>

missä <indeksivaihtoehtoluettelo> voi olla: PRIMARY | DISALLOW NULL | IGNORE NULL

Vain Microsoft Access -ohjain käyttää DISALLOW NULL ja IGNORE NULL -indeksivaihtoehtoja. dBASE- ja Paradox-ohjaimet hyväksyvät syntaksin, mutta eivät käytä kumpaakaan.

Käytettäessä Paradox-ohjainta CREATE INDEX -lause luo Paradoxin perusavaintiedostot ja toissijaiset tiedostot.

Microsoft Excel - ja Teksti-ohjaimet eivät tue tätä lausetta.


Päivämäärälaskenta

Ohjain tukee kokonaislukujen lisäämistä ja vähentämistä DATE-, TIME- ja TIMESTAMP-tietosarakkeissa. DATE-sarakkeessa kokonaisluku määrittää lisättävien tai vähennettävien päivien määrän. TIME- ja TIMESTAMP-sarakkeissa kokonaisluku määrittää lisättävien tai vähennettävien sekuntien määrän.


Päivämäärä-, kellonaika- ja päiväysliteraalit

Moniympäristökäyttö on tehokkainta silloin, kun sovellukset välittävät päivämääräliteraalit hyväksytyssä ODBC-muodossa escape-lauseessa.

•	Päivämääräliteraalien escape-lauseen syntaksi on {d 'arvo'}, missä arvo on muodossa “vvvv-kk-pp”.

•	Kellonaikaliteraalien escape-lauseen syntaksi on {t 'arvo'}, missä arvo on muodossa “hh:mm:ss”.

•	Päiväysliteraalien escape-lauseen syntaksi on {ts 'arvo'}, missä arvo on muodossa “vvvv-kk-pp hh:mm:ss[.f…]”.


DROP INDEX -lause

Käytettäessä Microsoft Access-, dBASE- tai Paradox -ohjainta DROP INDEX -lauseen syntaksi on "DROP INDEX a ON b", missä "a" on indeksin nimi ja "b" on taulukon nimi (ei DROP INDEX indeksi-nimi).

Käytettäessä Paradox-ohjainta DROP INDEX -lause poistaa Paradoxin toissijaiset indeksitiedostot.

DROP INDEX -lause ei ole tuettu Microsoft Excel- ja Teksti-ohjaimessa.


Kiinteäleveyksinen tekstitiedosto

Käytettäessä Teksti-ohjainta kiinteäleveyksisen tekstitiedoston viimeisen sarakkeen pituus voi vaihdella.


GROUP BY -lausekeluettelo

GROUP BY -osa tukee sarakkeiden nimien lisäksi lausekeluetteloa. GROUP BY -osan sisältävän SELECT-lauseen valintaluettelossa voi olla lausekkeita vain GROUP BY -osan tai joukkofunktioiden osina


ORDER BY -lausekeluettelo

Lausekkeita voidaan käyttää ORDER BY -osassa Esimerkiksi seuraavissa lauseissa taulukko järjestetään kolmella avainlausekkeella: a+b, c+d ja e.

SELECT * FROM henk
ORDER BY a+b,c+d,e

ORDER BY -osaa ei voi käyttää joukkofunktioissa tai niitä sisältävässä lausekkeessa.


ORDER BY -osa GROUP BY -lausekeluettelon yhteydessä

ORDER BY-osaa voidaan käyttää kaikissa GROUP BY -lausekeluettelon lausekkeissa tai kaikissa tulosjoukon sarakkeissa.


Ulkoliitokset

SELECT-lauseessa voi olla OUTER JOIN -osien luettelo. Sisäkkäisiä ulkoliitoksia tuetaan. Lisätietoja OUTER JOIN -osasta on Microsoft Jet Database Engine Programmers’s Guide -oppaassa.


Skalaarifunktiot

Microsoft ODBC Desktop Database -ohjaimet tukevat seuraavia skalaarifunktioita:

CONCAT	LCASE	RIGHT
CONVERT	LEFT	RTRIM
CURDATE	LENGTH	SUBSTRING
CURTIME	LOCATE	UCASE
DATABASE	LTRIM	USER
DAYOFMONTH	MOD	YEAR
DAYOFWEEK	MONTH
Lisätietoja skalaarifunktioiden argumenteista ja palautusarvoista on julkaisun Microsoft ODBC Programmer's Reference liitteessä F.


Taulukkonimet

Käytettäessä dBASE-, Microsoft Excel-, Paradox- tai Teksti-ohjainta SELECT- tai DELETE-lauseen FROM-osassa, INSERT-lauseen INTO-osan jäljessä tai UPDATE-, CREATE TABLE- ja DROP TABLE -lauseiden jäljessä esiintyvässä taulukkonimessä saa olla polku, tiedostonimen vartalo ja tiedostonimen tunniste.

Jos taulukkonimeä käytetään jossain muussa SQL-lauseessa, ohjelma ei tue polkujen tai tunnisteiden käyttöä, vaan hyväksyy ainoastaan taulukon tiedostonimen vartalo-osan (esimerkiksi HENK FROM C:\ABC\HENK).

Korrelaationimiä (kutsumanimiä) voidaan käyttää.

Esimerkiksi:

SELECT *
FROM C:\ABC\HENK T1
WHERE T1.COL1 = 'aaa'


Koostefunktioiden rajoitukset

Koostefunktiota ja koostefunktioita sisältämätöntä sarakeviittausta ei voi käyttää argumentteina samassa SQL-lauseessa.


ALTER TABLE -lauseen rajoitukset

Katso myös

Käytettäessä dBASE- tai Paradox-ohjainta taulukon rakennetta ei voi enää muuttaa ALTER TABLE -lauseella sen jälkeen, kun indeksi on luotu ja uusi tietue on lisätty taulukkoon. ALTER TABLE -lausetta voi käyttää vain, jos indeksi ja taulukon sisältö poistetaan.

ALTER TABLE -lause ei ole tuettu Microsoft Excel- ja Teksti-ohjaimessa.

Huomautus   Kun käytät Paradox-ohjainta mutta et Borland Database Engine -moduulia, ALTER TABLE -lauseet eivät ole tuettuja. Vain APPEND-lauseet ja lukutilan lauseet ovat tällöin sallittuja.


AND-predikaatin rajoitukset

Lause voi sisältää enintään 40 AND-predikaattia.


CALL -lauseen rajoitukset

(Tämä rajoitus koskee vain Microsoft Access -ohjainta.)

Lausekkeiden käyttämistä toimintosarjakutsun parametreina ei tueta.


Sarakkeiden nimien rajoitukset

Sarakkeiden nimissä voi käyttää muutamaa poikkeusta lukuun ottamatta mitä tahansa merkkejä (esimerkiksi välilyöntejä). Jos sarakkeiden nimissä on muita merkkejä kuin kirjaimia, numeroita ja alaviivoja, nimi on kirjoitettava gravisaksenttimerkkeihin (`).

Kun käytetään Microsoft Access tai Microsoft Excel -ohjainta, sarakkeiden nimien enimmäispituus on 64 merkkiä, ja pitemmät nimet aiheuttavat virheen. Käytettäessä Paradox -ohjainta sarakkeen nimen enimmäispituus on 25 merkkiä. Käytettäessä Teksti-ohjainta sarakkeen nimen enimmäispituus on 64 merkkiä ja tätä pitemmät nimet katkaistaan.

Käytettäessä dBASE -ohjainta merkit, joiden ASCII -arvo on suurempi kuin 127, muunnetaan alaviivoiksi.

Sarakkeiden nimien on oltava ensimmäisellä rivillä käytettäessä Microsoft Excel -ohjainta. Microsoft Excel -nimi, jossa on "!"-merkki, on kirjoitettava gravisaksenttimerkkeihin ("`").Microsoft Excel -nimen "!"-merkki muuntuu dollarin merkiksi ($), koska huutomerkki ei kelpaa ODBC-nimessä, vaikka nimi kirjoitettaisiin gravisaksenttimerkkeihin. Kaikkia muita Microsoft Excel -merkkejä (paitsi pystyviivaa (|)) välilyönnit mukaan luettuna voidaan käyttää sarakkeiden nimissä. Kun haluat välilyönnin sarakkeen nimeen, nimi on ympäröitävä erotinmerkeillä. Ohjain antaa nimeämättömille sarakkeille omat nimet, esimerkiksi "Col1" ensimmäisen sarakkeen nimeksi.

Pystyviivaa (|) ei voi käyttää sarakkeiden nimissä riippumatta siitä, onko nimet kirjoitettu gravisaksenttimerkkeihin vai ei.

Teksti-ohjain antaa sarakkeelle oletusnimen, jos sarakkeen nimeä ei ole määritetty, esimerkiksi F1 ensimmäisen sarakkeen nimeksi, F2 toisen sarakkeen nimeksi jne.


CONVERT-funktion rajoitukset

Tietotyypin muuntamisen epäonnistuminen muuttaa muunnettavan sarakkeen arvoksi NULL (tyhjä).

DATE- ja TIMESTAMP-tietotyyppejä ei voi muuntaa toisiksi tietotyypeiksi (tai itsekseen) käyttämällä CONVERT-funktiota.


CREATE INDEX -lauseen rajoitukset

Katso myös

Microsoft Excel- ja Teksti-ohjain eivät tue CREATE INDEX -lausetta.

Indeksi voidaan määrittää enintään 10 sarakkeelle kerrallaan. Jos CREATE INDEX -lauseessa määritetään enemmän kuin 10 saraketta, ohjelma ei tunnista indeksiä ja käsittelee taulukkoa indeksittömänä taulukkona.

dBASE-ohjain ei pysty luomaan indeksiä LOGICAL-sarakkeelle.

Käytettäessä dBASE-ohjainta voidaan laajojen tiedostojen käsittelyä nopeuttaa luomalla .mdx-indeksi (tai .ndx-indeksi) SELECT-lauseen WHERE-osassa määritetylle sarakkeelle (kentälle). Olemassa olevia .mdx.-indeksejä hyödynnetään automaattisesti käytettäessä =, >, <, >=, =< ja BETWEEN-operaattoreita WHERE-osassa, samoin kuin käytettäessä LIKE-predikaattia ja liitostoimintoja.

dBASE-ohjainta käytettäessä CREATE UNIQUE INDEX -lauseella luotu indeksi ei määritä sarakkeen sisältämien tietojen yksilöllisyyttä, vaan indeksin saaneeseen sarakkeeseen voidaan lisätä samat arvot kahteen kertaan. UNIQUE määrittää ainoastaan, että saman avainarvon sisältävistä tietueista vain yksi lisätään indeksiin.

Paradox-ohjainta käytettäessä yksilöllinen indeksi, on määritettävä taulukon peräkkäisille sarakkeille, ja ensimmäinen sarake on sisällytettävä mukaan. Paradox-ohjain ei pysty päivittämään taulukkoa, ellei taulukolle ole määritetty yksilöllistä indeksiä tai jos Paradox-ohjainta käytetään ilman Borland Database Engine -moduulia.


CREATE TABLE -lauseen rajoitukset

Kun teksti- tai binaarityypin sarakkeen pituutta ei ole määritetty (tai pituudeksi on määritetty 0) käytettäessä Microsoft Access-, Microsoft Excel- tai Paradox-ohjainta, ohjelma määrittää sarakkeen pituusarvoksi 255.

Kun teksti- tai binaarityypin sarakkeen pituutta ei ole määritetty (tai pituudeksi on määritetty 0) käytettäessä dBASE-ohjainta, ohjelma määrittää sarakkeen pituusarvoksi 254.

Sarakkeiden enimmäismäärä on 255.

Luotava laskentataulukko ei saa olla samanniminen kuin aiemmin poistettu laskentataulukko käytettäessä Microsoft Excel -ohjainta Microsoft Excel 5.0-, 7.0- tai 97-tietolähteen yhteydessä. Kun Microsoft Excel -ohjaimella käsitellään Excel 5.0-, 7.0- tai 97-laskentataulukkoa, DROP TABLE -lause tyhjentää laskentataulukon, mutta ei poista sen nimeä.

Paradox-ohjainta käytettäessä sarakkeita ei voi enää lisätä taulukkoon indeksin määrittämisen jälkeen. Jos CREATE TABLE -lauseen argumenttiluettelon ensimmäiselle sarakkeelle määritetään indeksi, argumenttiluetteloon ei voi lisätä toista saraketta


Päivämäärälaskennan rajoitukset

Päivämäärälaskentaa ei voi käyttää DATE-tietotyypin arvojen vähentämiseen DATE-tietotyypin arvoista.


DELETE-lauseen rajoitukset

Microsoft Excel- ja Teksti-ohjain eivät tue DELETE-lausetta. Teksti-ohjain kuitenkin tukee INSERT-lausetta.

dBASE-ohjain eivät kumpikaan tue poistomerkittyjen tietueiden poistamista tietokannan tiivistämisen yhteydessä.

Paradox-ohjain pystyy poistamaan taulukosta rivejä vain, jos taulukolla on yksilöllinen indeksi (Paradox-perusavain).


DISTINCT-avainsanan rajoitukset

Avainsanaa ei tueta Long Text -kentissä (Microsoft Access) eikä Memo-kentissä (dBASE).


DROP INDEX -lauseen rajoitukset

Microsoft Excel- ja Teksti-ohjain eivät tue DROP INDEX -lausetta.


DROP TABLE -lauseen rajoitukset

Microsoft Excel versioiden 5.0, 7.0 tai 97 ohjainta käytettäessä DROP TABLE -lause tyhjentää laskentataulukon, mutta ei poista sen nimeä. Laskentataulukon nimi jää työkirjaan, mikä aiheuttaa sen, että käyttäjä ei voi luoda toista samannimistä laskentataulukkoa.


FROM-lauseen rajoitukset

FROM-osan sisältämien taulukoiden enimmäismäärä on 16.


HAVING-lauseen rajoitukset

HAVING-osan sisältämien hakuehtojen enimmäismäärä on 40.


Tunnisteiden rajoitukset

Jos tunnisteessa on välilyöntejä tai erikoismerkkejä, se on kirjoitettava gravisaksenttien väliin. Tunniste voi olla enintään 64 merkkiä pitkä, eikä sen ensimmäinen kirjain saa olla välilyönti. Nimissä ei saa olla ohjausmerkkejä eikä seuraavia erikoismerkkejä: ` | # * ? [ ] . ! $ .

Älä käytä Microsoft ODBC Programmer's Reference -oppaan liitteessä C olevassa SQL-kieliopissa mainittuja varattuja sanoja (tai niiden lyhenteitä) tunnisteina (taulukoiden tai sarakkeiden niminä), ellet kirjoita niitä gravisaksenttimerkkeihin (`).


Indeksien nimien rajoitukset

Paradox-ohjainta käytettäessä ensisijaisella indeksillä on oltava sama nimi kuin taulukolla, jolle se on määritetty. Muilla yksilöllisillä tai ei-yksilöllisillä indekseillä on oltava sama nimi kuin sarakkeella, jolle ne on määritetty.


INSERT-lauseen rajoitukset

Jos taulukkoon lisätyt tiedot eivät sovi sarakkeeseen, ohjelma katkaisee ne oikealta päin varoittamatta siitä etukäteen.

Jos yrität lisätä taulukkoon sarakkeen tietotyypin vastaisen arvon, ohjelma lisää sarakkeeseen NULL-arvon (tyhjä).

Käytettäessä dBASE-, Microsoft Excel-, Paradox- tai Teksti-ohjaimia tyhjän merkkijonon lisääminen sarakkeeseen lisää siihen NULL-arvon.

Jos tyhjä merkkijono lisätään sarakkeeseen käytettäessä Microsoft Excel -ohjainta, ohjelma muuntaa merkkijonon NULL-arvoksi; SELECT-lause, jonka WHERE-osa määrittää tyhjän merkkijonon, ei toteuta valintaa tässä sarakkeessa.

Paradox-ohjain ei pysty päivittämään taulukkoa seuraavissa tapauksissa:

•	Taulukolle ole määritetty yksilöllistä indeksiä. Tämä ei päde tyhjään taulukkoon, johon voidaan lisätä yksi rivi ilman indeksiä. Jos tyhjään taulukkoon, jolla ei ole yksilöllistä indeksiä, lisätään yksi rivi, sovellus ei sen jälkeen pysty luomaan sille yksilöllistä indeksiä eikä lisäämään siihen tietoja.

•	Borland Database Engine -moduuli ei ole käytössä. Tällöin vain APPEND-lauseet ja lukutilan lauseet ovat sallittuja Paradox-taulukossa.

Teksti-ohjainta käytettäessä kiinteämittaisten tiedostojen NULL-arvoja edustavat pelkistä välilyönneistä muodostuvat merkkijonot, kun taas erotinta käyttävien tiedostojen NULL-arvot ilmaistaan jättämällä arvo kokonaan pois. Esimerkiksi alla olevassa rivissä on kolme kenttää, joista toinen on NULL-arvo.

     "Virtanen:,, 123

Teksti-ohjainta käytettäessä sarakearvoissa voi olla edeltäviä välilyöntejä. Rivien enimmäispituus on 65 543 tavua.


LIKE-predikaatin rajoitukset

Jos sarakkeen sisältämät tiedot ovat yli 255 merkkiä pitkät, LIKE-vertailu suoritetaan vain 255 ensimmäisen merkin perusteella.

Toimintosarjassa käytettävässä LIKE-vertailussa voidaan käyttää vain vakioyleismerkkejä. Desktop Database -ohjaimet tukevat SQL 92:n LIKE-vertailua.

Escape-lauseen käyttöä LIKE-predikaatissa ei tueta.

LIKE-vertailua ei tulisi suorittaa sarakkeelle, joka sisältää lukuja tai Float-tietotyypin tietoja. Seuraukset voivat olla odottamattomat. Saat lisätietoja julkaisusta Microsoft Jet Database Engine Programmers’s Guide.


NOT NULL -rajoitukset

CREATE TABLE -lauseen CONSTRAINT-osan NOT NULL -avainsanaa ei tueta.


ORDER BY -lauseen rajoitukset

Jos SELECT-lauseessa on sekä GROUP BY- että ORDER BY -osa, ORDER BY -osassa voi olla vain jokin tulosjoukon sarakkeista tai GROUP BY -osan lauseke.


Parametroidun kyselyn rajoitukset

Käytettäessä Microsoft Access -ohjainta parametroitua kyselyä voi kutsua käyttämällä seuraavaa syntaksia: CALL kyselyn-nimi [(parametri[,parametri]...)].


Varattujen sanojen rajoitukset

Älä käytä Microsoft ODBC Programmer's Reference -oppaan liitteessä C olevassa SQL-kieliopissa mainittuja varattuja sanoja (tai niiden lyhenteitä) tunnisteina (taulukoiden tai sarakkeiden niminä), ellet kirjoita niitä gravisaksenttimerkkeihin (`).


Skaalaarifunktioiden rajoitukset

Skalaarifunktioita tuetaan vain, jos ne ovat hyväksytyssä ODBC-esitysmuodossa.


SELECT DISTINCT -rajoitukset

DISTINCT-avainsanaa ei voi käyttää binaaritietojen kanssa.


SELECT -lauseen rajoitukset

SELECT-lauseessa ei voi käyttää sekä koostefunktiosarakkeita että muita sarakkeita.

GROUP BY -osan sisältävän SELECT-lauseen valintaluettelossa voi olla vain GROUP BY -osan lausekkeita tai joukkofunktioiden lausekkeita.

GROUP BY -osan sisältävässä SELECT-lauseessa ei tueta tähden käyttöä (kaikkien sarakkeiden valitsemiseen). Valittavien sarakkeiden nimet on määritettävä erikseen.

SELECT-lauseessa ei tueta pystyviivan käyttöä. Jos sinun on viitattava tietoarvoon, jossa on pystyviiva, käytä parametria.

Kun SELECT-lauseessa käytetään sarakkeen kutsumanimeä, kutsumanimen edessä on oltava sana “as”. Esimerkiksi “SELECT col1 as a from b.” Ilman “as”-sanaa lause aiheuttaa virheen.

Jos SELECT-lauseeseen kirjoitetaan virheellinen sarakkeen nimi, ohjelma näyttää SQLSTATE 07001 -virhesanoman “Parametrien määrä on virheellinen” SQLSTATE S0022 -virhesanoman “Saraketta ei löydy” sijasta.

Jos sarakkeeseen lisätään tyhjä merkkijono käytettäessä Microsoft Excel -ohjainta, ohjelma muuntaa merkkijonon NULL-arvoksi; SELECT-lause, jonka WHERE-osa määrittää tyhjän merkkijonon, ei toteuta valintaa tässä sarakkeessa.


Joukkofunktioiden rajoitukset

Joukkofunktiot (AVG, MAX, MIN ja SUM) eivät tue DISTINCT-avainsanaa.


Lajittelurajoitukset

Lajitteluavaimen enimmäispituus GROUP BY -osassa, ORDER BY -osassa, SELECT DISTINCT -lauseessa ja ulkoliitoksessa on 255 tavua. Kaikkien lajittelurivin lajitteluavainten enimmäispituus on 65 500 tavua.


Merkkijonorajoitukset

SQL-lauseen merkkijonon enimmäispituus on 65 000 merkkiä.

Microsoft Access -ohjainta käytettäessä vain SQL 92 -merkkijonovakioita (puolilainausmerkeissä, ei lainausmerkeissä) tuetaan.

Pystyviivaa (|) ei voi käyttää merkkijonossa riippumatta siitä, onko merkki kirjoitettu gravisaksenttimerkkeihin vai ei.

Moniympäristökäyttö on tehokkainta, jos sovellukset välittävät merkkijonot parametreina erotinmerkein varustettujen merkkijonojen asemesta


Taulukkonimien rajoitukset

Taulukkojen nimissä voi käyttää muutamaa poikkeusta lukuun ottamatta mitä tahansa merkkejä (esimerkiksi välilyöntejä). Jos taulukon nimessä on muita merkkejä kuin kirjaimia, numeroita tai alaviivoja, nimi on kirjoitettava gravisaksenttimerkkeihin (`).

Kun tietokantaviittaus ei määritä taulukon nimeä käytettäessä Microsoft Excel -ohjainta, viittaus kohdistetaan oletustietokantaan. Microsoft Excel -taulukon nimessä mahdollisesti oleva huutomerkki (!) muunnetaan automaattisesti dollarin merkiksi ($).

Microsoft Excel 3.0/4.0 -tiedostojen osalta Microsoft Excel -taulukkonimi voi olla <laskutaulukon_nimi>. Microsoft Excel 5.0/ 7.0/ 97 -tiedostojen osalta Microsoft Excel -taulukkonimi voi olla <työkirjan_nimi>.

dBASE-ohjainta käytettäessä ohjelma muuntaa alaviivoiksi merkit, joiden ASCII-arvo on suurempi kuin 127.

Microsoft Access -ohjainta käytettäessä taulukon nimen enimmäispituus on 64 merkkiä.

Käytettäessä dBASE-, Microsoft Excel 3.0/4.0-, Paradox- tai Teksti-ohjainta MS-DOS-avainsanoja CON, AUX, LPT1 ja LPT2 ei saa käyttää taulukkoniminä.


Taulukkoviiterajoitukset

Kyselylauseessa voi olla enintään 16 taulukkoviittausta.


UPDATE -lauseen rajoitukset

Jotta Paradox-ohjain voisi päivittää taulukon, taulukolla on oltava yksilöllinen indeksi (Paradox-perusavain). Kun käytät Paradox-ohjainta käyttämättä Borland Database Engine -moduulia, Paradox-taulukon päivittäminen ei ole mahdollista.

Teksti-ohjain ei tue UPDATE-lauseen käyttöä.

Käytettäessä Microsoft Excel -ohjainta arvoja voidaan päivittää, mutta Microsoft Excel -laskentataulukkoon pohjautuvasta taulukosta ei voi poistaa rivejä. Tästä seuraa, että Microsoft Excel -ohjain ei virallisesti tue UPDATE-lausetta. Ohjain tukee virallisesti vain INSERT-lausetta.


Näkymien rajoitukset

dBASE-, Microsoft Excel-, Paradox- ja Teksti -ohjain eivät tue näkymiä.


WHERE -osan rajoitukset

WHERE-osan sisältämien osien enimmäismäärä on 40.

LONGVARBINARY- ja LONGVARCHAR-sarakkeita voidaan verrata enintään 255 merkin pituisin literaalein, mutta niitä ei voi verrata parametreja käyttäen.


WHERE CURRENT OF -osan rajoitukset

WHERE CURRENT OF -osan käyttöä ei tueta.


dBASE-indeksit (laajennettu kielioppi)

Katso myös

ODBC dBASE -ohjain avaa ja päivittää dBASE IV -indeksitiedostot automaattisesti. Voit liittää dBASE III .ndx -tiedostoja dBASE-tiedostoihin ainoastaan ODBC-ohjauspaneelin Valitse indeksit -valintaikkunan avulla.

dBASE-indeksien luomista rajoittavat seuraavat säännöt:

•	Kaikkien sarakkeiden nimien on oltava kelvollisia.

•	Kaikkien sarakkeiden on oltava samassa nousevassa tai laskevassa järjestyksessä.

•	Yksittäisen tekstisarakkeen enimmäispituus on 100 tavua.

•	Jos sarakkeita on enemmän kuin yksi, niiden kaikkien on oltava tekstisarakkeita ja niiden yhteiskoon on oltava alle 100 tavua.

•	Memo-kentille ei voi määrittää indeksejä.

•	Nykyiselle avainkenttäjoukolle ei saa määrittää indeksejä (indeksejä ei saa määrittää kahteen kertaan).

•	Indeksin nimen on oltava dBASE-indeksien nimeämissääntöjen mukainen. dBASE III edellyttää, että kukin indeksi on omassa, erillisessä tiedostossaan, joilla kaikilla on .ndx-tunniste. dBASE IV luo indeksit tunnisteniminä, jotka tallennetaan samaan .mdx-tiedostoon. Tällä .mdx-tiedostolla on sama vartalo kuin tietokantatiedostolla (esimerkiksi Henk.mdx on Henk.dbf-tietokannan indeksitiedosto).


Paradox-ohjaimen CREATE INDEX -lause (laajennettu kielioppi)

Katso myös

ODBC Paradox -ohjaimessa käytettävän CREATE INDEX -lauseen syntaksi on seuraava:

CREATE [UNIQUE] INDEX indeksin-nimi
   ON taulukon-nimi
   (saraketunnus [ASC]
    [, saraketunnus [ASC]...])

ODBC Paradox -ohjain ei tue ODBC SQL -kieliopissa määritettyä DESC-avainsanaa CREATE INDEX -lauseen yhteydessä. Taulukon-nimi-argumentilla voidaan määrittää taulukon täydellinen polunnimi.

Jos UNIQUE-avainsana on määritetty, ODBC Paradox -ohjain luo yksilöllisen indeksin. Ensimmäisenä luotu yksilöllinen indeksi on ensisijainen indeksi eli Paradoxin perusavaintiedosto, jonka nimi on taulukon-nimi.px. Ensisijaisia indeksejä koskevat seuraavat rajoitukset:

•	Ensisijainen indeksi on luotava ennen kuin taulukkoon on vielä lisätty rivejä.

•	Ensisijainen indeksi on määritettävä taulukon ensimmäiselle sarakkeelle, ja valinnaisesti sitä seuraaville, peräkkäisille sarakkeille.

•	Kullakin taulukolla voi olla vain yksi ensisijainen indeksi.

•	Paradox-ohjain ei pysty päivittämään taulukkoa, jos taulukolle ei ole määritetty ensisijaista indeksiä. (Tämä ei päde tyhjään taulukkoon, jota voidaan päivittää ilman yksilöllistä indeksiä.)

•	Ensisijaisen indeksin indeksin-nimi-argumentin on oltava sama kuin taulukon vartalo.

Jos UNIQUE-avainsana jätetään lauseesta pois, ODBC Paradox -ohjain luo ei-yksilöllisen indeksin. Tämä indeksi muodostuu kahdesta toissijaisesta Paradox-indeksitiedostosta, joiden nimet ovat taulukon-nimi.Xnn ja taulukon-nimi.Ynn. Merkit nn ilmaisevat sarakkeen numeron taulukossa. Ei-yksilöllisiä indeksejä koskevat seuraavat rajoitukset:

•	Ei-yksilöllinen indeksi voidaan luoda taulukolle vain, jos taulukolla on jo ensisijainen indeksi.

•	Käytettäessä Paradox versiota 3.x muiden kuin ensisijaisten indeksien (yksilöllisten tai ei-yksilöllisten indeksien) indeksin-nimi-argumentin on oltava sama kuin sarakkeen nimi. Käytettäessä Paradox versioita 4.x ja 5.x tällaisten indeksien nimien ei ole välttämättä oltava samat kuin sarakkeen nimi.

•	Ei-yksilöllistä indeksiä määritettäessä voidaan käyttää vain yhtä saraketta.

Kun taulukolle on määritetty indeksi, taulukkoon ei voi enää lisätä sarakkeita. Jos CREATE TABLE -lauseen argumenttiluettelon ensimmäinen osa määrittää sarakkeelle indeksin, argumenttiluetteloon ei voi lisätä toista saraketta.

Voit esimerkiksi käyttää myyntitilausnumero- ja rivinumerosarakkeita MT_RIVIT-taulukon yksilöllisenä indeksinä seuraavassa kuvatun lauseen avulla:

CREATE UNIQUE INDEX MT_RIVIT
   ON MT_RIVIT (MTNro, RiviNro)

Voit käyttää osanumerosaraketta MT_RIVIT-taulukon ei-yksilöllisenä indeksinä seuraavassa kuvatun lauseen avulla:

CREATE INDEX OsaNro
   ON MT_RIVIT (OsaNro)

Ota huomioon, että suoritettaessa kaksi CREATE INDEX -lausetta ensimmäinen lause luo aina ensisijaisen indeksin, jolla on sama nimi kuin taulukolla, ja toinen lause luo ei-yksilöllisen indeksin, jolla on sama nimi kuin sarakkeella. Indeksit nimetään aina samalla tavoin, vaikka CREATE INDEX -lauseisiin kirjoitettaisiin eri nimet ja toisen CREATE INDEX -lauseen indeksi olisi luotu käyttämällä avainsanaa UNIQUE.

Huomautus   Kun käytät Paradox-ohjainta mutta et Borland Database Engine -moduulia, vain APPEND-lauseet ja lukutilan lauseet ovat sallittuja.


Microsoft Access -tietotyypit (laajennettu kielioppi)

Microsoft Access -tietotyypit, taulukoiden luomiseen käytettävät tietotyypit ja ODBC SQL -tietotyypit on kuvattu seuraavassa:

Microsoft Access -tietotyyppi:	Tietotyyppi (CREATETABLE:)	ODBC SQL -tietotyyppi:
BIGBINARY(1)	LONGBINARY	SQL_LONGVARBINARY
BINARY	BINARY	SQL_BINARY
BIT	BIT	SQL_BIT
COUNTER	COUNTER	SQL_INTEGER
CURRENCY	CURRENCY	SQL_NUMERIC
DATE/TIME	DATETIME	SQL_TIMESTAMP
GUID	GUID	SQL_GUID
LONG BINARY	LONGBINARY	SQL_LONGVARBINARY
LONG TEXT	LONGTEXT	SQL_LONGVARCHAR (2) SQL_WLONGVARCHAR(3)
MEMO	LONGTEXT	SQL_LONGVARCHAR (2) SQL_WLONGVARCHAR(3)
NUMBER (FieldSize= SINGLE)	SINGLE	SQL_REAL
NUMBER (FieldSize= DOUBLE)	DOUBLE	SQL_DOUBLE
NUMBER (FieldSize= BYTE)	UNSIGNED BYTE	SQL_TINYINT
NUMBER (FieldSize= INTEGER)	SHORT	SQL_SMALLINT
NUMBER (FieldSize= LONG INTEGER)	LONG	SQL_INTEGER
NUMERIC	NUMERIC	SQL_NUMERIC
OLE	LONGBINARY	SQL_LONGVARBINARY
TEXT	VARCHAR	SQL_VARCHAR (1) SQL_WVARCHAR(2)
VARBINARY	VARBINARY	SQL_VARBINARY
1 Vain Access 4.0 -sovellukset. Enimmäispituus on 4000 tavua. Toimii samoin kuin LONGBINARY.

2 Vain ANSI-sovellukset.

3 Vain Unicode- ja Access 4.0 -sovellukset.

Huomautus:   SQLGetTypeInfo-funktio palauttaa ODBC-tietotyypit. Funktio ei palauta kaikkia Microsoft Access -tietotyyppejä, jos samaa ODBC SQL -tietotyyppiä vastaa useampia kuin yksi Microsoft Access -tietotyyppi. Kaikki yllä olevassa taulukossa luetellut SQL-tietotyypit tukevat julkaisun Microsoft ODBC Programmer's Reference -oppaan liitteessä D mainittuja tietotyyppimuunnoksia.

Microsoft Access -tietotyyppien rajoitukset on lueteltu seuraavassa:

Tietotyyppi:	Kuvaus:
BINARY, VARBINARY ja VARCHAR	Jos luodaan BINARY-, VARBINARY- tai VARCHAR-tietotyypin sarake, jonka pituutta ei määritetä tai pituudeksi määritetään 0, sarake luodaan 255 tavun mittaisena.
BYTE	Vaikka Microsoft Access -ohjaimen NUMBER-kenttä, jonka kentän koko vastaa BYTE-tietotyyppiä on etumerkitön, kenttään voidaan lisätä negatiivinen luku käytettäessä Microsoft Access -ohjainta.
CHAR, LONGVARCHAR ja VARCHAR	Merkkijonoliteraalissa voi olla mitä tahansa ANSI-merkkejä (kymmenlukujärjestelmän arvot 1 - 255). Käytä kahta peräkkäistä puolilainausmerkkiä ('') merkitsemään yhtä puolilainausmerkkiä (').Jos merkkitietotyypin sarakkeissa käytetään erikoismerkkejä, merkkitiedot tulisi välittää muuttujien avulla.
DATE	Päivämääräarvot on määritettävä joko hyväksytyn ODBC-päivämäärämuodon mukaan tai päivämäärän erottimella (“#”). Muutoin Microsoft Access käsittelee arvoa aritmeettisena lausekkeena eikä näytä varoitusta tai virhesanomaa. Esimerkiksi päivämäärä “5. maaliskuuta 1996” on kirjoitettava muotoon {d ‘1996-03-05’} tai #03/05/1996#; jos päivämäärä kirjoitetaan muodossa 05/03/1996, Microsoft Access tulkitsee tämän merkitsevän samaa kuin 5 jaettuna 3:lla jaettuna 1996:lla. Tulokseksi saatu arvo pyöristetään kokonaisluvuksi 0, ja koska nollapäivämäärä, josta lähtien päivämäärät lasketaan, on 31.12.1899, ohjelma käyttää tätä päivämäärää.Päivämääräarvossa ei voi olla pystyviivaa (|) edes gravisaksentteihin kirjoitettuna.
GUID	Tietotyyppi rajoitettu Microsoft Access 4.0 -ohjelmaan.
NUMERIC	Tietotyyppi rajoitettu Microsoft Access 4.0 -ohjelmaan.
Lisätietoja tietotyyppien rajoituksista on ohjeaiheessa Tietotyyppien rajoitukset.


dBASE-tietotyypit (laajennettu kielioppi)

Seuraavassa taulukossa kuvataan, mitä ODBC SQL -tietotyyppejä dBASE-tietotyypit vastaavat. Huomaa, ettei kaikkia ODBC SQL -tietotyyppejä tueta.

DBASE-tietotyyppi:	ODBC-tietotyyppi:
CHAR	SQL_VARCHAR
DATE	SQL_DATE
FLOAT *	SQL_DOUBLE
LOGICAL	SQL_BIT
MEMO	SQL_LONGVARCHAR
NUMERIC (BCD)	SQL_DOUBLE
OLEOBJECT *	SQL_LONGBINARY
* Käytössä vain dBASE versiossa 5.x

dBASE III sallii lukujen ilmaisemisen kantaluvun 10 kaksinumeroisen eksponentin ja dBASE IV kolminumeroisen eksponentin tarkkuudella. Koska luvut on tallennettu tekstimuodossa, ne muunnetaan luvuiksi. Jos muunnettava luku ei sovi kenttään, tällä voi olla odottamattomia seurauksia.

dBASE sallii tarkkuuden ja desimaalien määrittämisen NUMERIC-tietotyypin määrittämisen yhteydessä, mutta ODBC dBASE -ohjain ei tue näitä määrityksiä, vaan palauttaa aina NUMERIC-tietotyypin tarkkuuden arvoksi 15 ja desimaalien määräksi 0.

ODBC dBASE -ohjaimella luotu lukusarake vastaa tietotyypiltään SQL_DOUBLE ODBC -tietotyyppiä. Sarakkeen lukuja on ehkä näin ollen ehkä pyöristettävä. Lukutietotyypit eivät vastaa toisiaan, sillä dBASEn lukutietotyyppi (N) on BCD-tyyppi (Binary Coded Decimal).

Huomautus:   SQLGetTypeInfo-funktio palauttaa ODBC SQL -tietotyypit. Kaikkia julkaisun Microsoft ODBC Programmer's Reference -liitteessä D mainittuja tietotyypin muunnoksia tuetaan tässä ohjeaiheessa mainittujen ODBC SQL -tietotyyppien osalta.

dBASE-tietotyyppien rajoitukset on kuvattu seuraavassa:

Tietotyyppi:	Kuvaus:
CHAR	CHAR-sarake, jonka pituudeksi on määritetty 0 tai jonka pituutta ei ole määritetty, palautetaan 254 tavun pituisena sarakkeena.
Salatut tiedot	dBASE-ohjain ei tue salattuja dBASE-taulukoita
LOGICAL	dBASE-ohjain ei pysty luomaan indeksiä LOGICAL-sarakkeelle.
MEMO	MEMO-sarakkeen enimmäispituus on 65 500 tavua.
Lisätietoja tietotyyppien rajoituksista on ohjeaiheessa Tietotyyppien rajoitukset.


Microsoft Excel -tietotyypit (laajennettu kielioppi)

Seuraavassa taulukossa kuvataan, mitä ODBC SQL -tietotyyppejä Microsoft Excel -ohjaimen tietotyypit vastaavat. Microsoft Excel -ohjain määrittää nämä tietotyypit Microsoft Excel -taulukoiden sarakkeisiin sarakkeiden sisältämien tietojen perusteella.

Microsoft Excel -tietotyyppi:	ODBC-tietotyyppi:
CURRENCY	SQL_NUMERIC
DATETIME	SQL_TIMESTAMP
LOGICAL	SQL_BIT
NUMBER	SQL_DOUBLE
TEXT	SQL_VARCHAR

Huomautus:   SQLGetTypeInfo-funktio palauttaa ODBC SQL -tietotyypit. Kaikkia julkaisun Microsoft ODBC Programmer's Reference -liitteessä D mainittuja tietotyypin muunnoksia tuetaan tässä ohjeaiheessa aiemmin lueteltujen ODBC SQL -tietotyyppien osalta.

Microsoft Excel -tietotyyppien rajoitukset on kuvattu seuraavassa:

Tietotyyppi:	Kuvaus:
Salatut tiedot	Microsoft Excel -ohjain ei pysty lukemaan salattuja tietoja.
Virhemerkkijonot	Microsoft Excel -ohjain ei pysty palauttamaan Microsoft Excel -virhearvoja (#PUUTTUU!, #ARVO!, #VIITTAUS!, #JAKO/0!, #LUKU!, #NIMI? ja #TYHJÄ!) merkkijonoina, vaan palauttaa sen sijaan NULL-arvon.
LOGICAL	LOGICAL-sarakkeen arvo palautetaan SQL_C_CHAR-puskurissa joko arvona 0 tai 1.
NUMBER	Jos luodaan kokonaislukusarake, siihen voidaan lisätä sekä lukuja, jotka ovat liian suuria Integer-tietotyypille, että muita kuin kokonaislukuja. Tästä seuraa, että sarake voidaan muuntaa SQL_DOUBLE-muotoon.
TEXT	Kun sarakkeen riveillä on useampaa kuin yhtä Microsoft Excel -tietotyyppiä, ODBC Microsoft Excel -ohjain määrittää sarakkeen tietotyypiksi SQL_VARCHAR-tietotyypin. Tästä säännöstä on yksi poikkeus: jos sarakkeessa on vain kahta tai kolmea päivämäärätietotyyppiä (DATE-, TIME- ja DATETIME-tietoja), ODBC Microsoft Excel -ohjain määrittää sarakkeen tietotyypiksi SQL_TIMESTAMP. TEXT-sarake, jonka pituus on määrittämätön tai 0, palautetaan 255 tavun pituisena sarakkeena. Merkkijonoliteraalissa voi olla mitä tahansa ANSI-merkkejä (kymmenlukujärjestelmän arvot 1 - 255). Käytä kahta peräkkäistä puolilainausmerkkiä ('') merkitsemään yhtä puolilainausmerkkiä ('). Jos muuhun kuin SQL_VARCHAR-sarakkeeseen lisätään NULL-arvo, sarakkeen tietotyyppi muuttuu SQL_VARCHAR-tietotyypiksi.
Lisätietoja tietotyyppien rajoituksista on ohjeaiheessa Tietotyyppien rajoitukset.


Paradox-tietotyypit (laajennettu kielioppi)

ODBC Paradox -ohjain määrittää Paradox-tietotyypit vastaamaan ODBC SQL -tietotyyppejä. Seuraavassa taulukossa on kuvattu kaikki Paradox-tietotyypit ja niitä vastaavat ODBC SQL -tietotyypit.

Paradox-tietotyyppi:	ODBC-tietotyyppi:
ALPHANUMERIC	SQL_VARCHAR
AUTOINCREMENT #	SQL_INTEGER
BCD #	SQL_DOUBLE
BYTES #	SQL_BINARY
DATE	SQL_DATE
IMAGE *	SQL_LONGVARBINARY
LOGICAL #	SQL_BIT
LONG #	SQL_INTEGER
MEMO *	SQL_LONGVARCHAR
MONEY #	SQL_DOUBLE
NUMBER	SQL_DOUBLE
SHORT	SQL_SMALLINT
TIME #	SQL_TIMESTAMP
TIMESTAMP #	SQL_TIMESTAMP
* Käytössä vain Paradox versioissa 4.x ja 5.x.

# Käytössä vain Paradox versiossa 5.x.

Huomautus:   SQLGetTypeInfo-funktio palauttaa ODBC SQL -tietotyypit. Kaikkia julkaisun Microsoft ODBC Programmer's Reference -liitteessä D mainittuja tietotyypin muunnoksia tuetaan tässä ohjeaiheessa aiemmin lueteltujen ODBC SQL -tietotyyppien osalta.

Paradox-tietotyyppien rajoitukset on kuvattu seuraavassa:

Tietotyyppi:	Kuvaus:
ALPHANUMERIC	ALPHANUMERIC-sarake, jonka pituus on määrittämätön tai 0, palautetaan 255 tavun pituisena sarakkeena.
BYTES	Jos binaarisarakkeeseen lisätään NULL-arvo käytettäessä Paradox 5 x -ohjainta, NULL muutetaan arvoksi 0.
LONG	Paradox-ohjaimen Long-tietotyypille Paradox versiossa 5.x tukema negatiivinen enimmäisarvo ei ole -2^31 (-2147483648), sillä Paradoxin Long-tietotyyppi korvataan ODBC:n SQL_INTEGER-tietotyypillä. Tuettu negatiivinen enimmäisarvo on -2^31 + 1 (-2147483647).
TIMESTAMP	Kun Paradox-ohjain lisää TIMESTAMP-sarakkeeseen arvon ja sen jälkeen hakee sen sarakkeesta, haettu arvo voi poiketa alkuperäisestä arvosta 1 sekunnin verran pyöristyksen vuoksi.
Lisätietoja tietotyyppien rajoituksista on ohjeaiheessa Tietotyyppien rajoitukset.


Text Data Types (laajennettu kielioppi)
Tekstitietotyypit (laajennettu kielioppi)

Seuraavassa taulukossa kuvataan, mitä ODBC SQL -tietotyyppejä Teksti-tietotyypit vastaavat. Ota huomioon, että ODBC Teksti -ohjain ei tue kaikkia ODBC SQL -tietotyyppejä.

Tekstitietotyyppi:	ODBC-tietotyyppi:
CHAR	SQL_VARCHAR
DATETIME	SQL_TIMESTAMP
FLOAT	SQL_DOUBLE
INTEGER	SQL_INTEGER
LONGCHAR	SQL_LONGVARCHAR

Huomautus:   SQLGetTypeInfo-funktio palauttaa ODBC-tietotyypit. Kaikkia Microsoft ODBC SDK Programmer's Reference -oppaan liitteessä D mainittuja tietotyypin muunnoksia tuetaan tässä ohjeaiheessa aiemmin lueteltujen ODBC SQL -tietotyyppien osalta.

Teksti-tietotyyppien rajoitukset on kuvattu seuraavassa:

Tietotyyppi:	Kuvaus:
CHAR	CHAR-sarake, jonka pituus on määrittämätön tai 0, palautetaan 255 pituisena sarakkeena. Erotelluissa tiedostoissa CHAR-sarakkeen alussa ja lopussa voi olla lainausmerkit; kiinteämittaisissa tiedostoissa ei käytetä lainausmerkkejä erottimina.
DATETIME	PP-KK-VV (esimerkiksi 17.01.92) PP-KKK-VV (esimerkiksi 17-Jan-1992) PP-KK-VVVV (esimerkiksi 17.01.1992) PP-KKK-VVVV (esimerkiksi 17-Jan-1992) Taulukossa ei saa olla sekamuotoisia päivämääräerottimia. Teksti-ohjaimen ISAM muotoilee DATETIME-kentän joko amerikkalaiseen tai eurooppalaiseen muotoon Windowsin Ohjauspaneelin Maakohtaiset asetukset -sovelluksen mukaan.
FLOAT	Enimmäisleveyteen sisältyy myös etumerkki ja desimaalipilkku. Schema.ini-tiedostossa leveys on merkitty seuraavalla tavalla: 14,083 on FLOAT Width 6 -14,083 on FLOAT Width 7 +14,083 on FLOAT Width 7 14083, on FLOAT Width 6 ODBC palauttaa aina FLOAT-sarakkeiden oletusleveyden arvoksi 8. FLOAT-sarakkeessa voidaan käyttää myös tieteellistä esitystapaa, esimerkiksi:-3.04E+2 on Float Width 8 25E4 on Float Width 4. Huomautus:   Sarakkeessa ei saa olla sekä desimaaleja että tieteellisen esitystavan mukaisia merkintöjä. Kiinteämittaisissa tiedostoissa NULL-arvot ilmaistaan pelkistä välilyönneistä muodostuvalla merkkijonolla; erotelluissa tiedostoissa ne jätetään kokonaan pois. FLOAT-arvoissa voi olla edeltäviä välilyöntejä.
INTEGER	INTEGER-sarakkeiden kelvolliset arvot ovat -32767 - 32766. Schema.ini-tiedostossa leveys on merkitty seuraavalla tavalla:14083 on INTEGER Width 5 0 on INTEGER Width 1 ODBC palauttaa aina INTEGER-sarakkeiden leveydeksi 4. Enimmäisleveyteen sisältyy etumerkki. INTEGER-sarakkeen enimmäisleveys on 11, vaikka leveys voi olla suurempikin kiinteämuotoisissa taulukoissa sallittujen tyhjien välien takia.
LONGCHAR	Kiinteämittaisen tai erotellun taulukon LONGCHAR-sarakkeen teoreettinen leveys on 65 500 merkkiä (tavua). Teksti-ISAM tukee luotettavasti enintään 32 kilotavun leveyttä.
Lisätietoja tietotyyppien rajoituksista on ohjeaiheessa Tietotyyppien rajoitukset.


Tietotyypin rajoitukset (laajennettu kielioppi)

Microsoft ODBC Desktop Database -ohjaimet rajoittavat tietotyyppejä seuraavassa kuvatuilla tavoilla:

Tietotyyppi:	Kuvaus:
Kaikki tietotyypit	Tietotyyppien muuntamisen epäonnistuminen voi johtaa siihen, että sarakkeen arvoksi tulee NULL.
BINARY	BINARY-sarake, jonka pituus on 0, palautetaan 255 tavun pituisena BINARY-sarakkeena.
DATE	DATE-tietotyyppiä ei voi muuntaa toiseksi tietotyypiksi (tai itsekseen) CONVERT-funktion avulla.
DECIMAL (Tarkka lukuarvo)	Ei tuettu.
Liukulukutietotyypit	Liukuluvun desimaalien määrää voidaan rajoittaa Windowsin Ohjauspaneelin Maakohtaisten asetusten Luku-välilehden asetusten avulla.
NUMERIC	Tukee enimmäistarkkuutta ja skaalaa 28:aa desimaalia
TIMESTAMP	TIMESTAMP-tietotyyppiä ei voi muuntaa itsekseen CONVERT-funktion avulla.
TINYINT	TINYINT-arvot ovat aina etumerkittömiä.
Tyhjät merkkijonot	Kun sarakkeeseen lisätään tyhjä merkkijono, sarakkeeseen tulee sen sijasta NULL-arvo käytettäessä dBASE-, Microsoft Excel-, Paradox- tai Teksti-ohjainta.


Virhesanomat (laajennettu kielioppi)

Virheen tapahtuessa Microsoft ODBC Desktop Database -ohjaimet näyttävät alkuperäisen virheen numeron, SQLSTATE-virheilmoituksen (ODBC-virhekoodin) ja virhesanoman.

Alkuperäinen virhe

Desktop Database -ohjaimet luovat positiivisia alkuperäisvirhekoodeja ja Microsoft Jet luo negatiivisia alkuperäisvirhekoodeja. Lisätietoja on julkaisussa Microsoft Jet Database Engine Programmers’s Guide.

SQLSTATE

ODBC-ohjain etsii vastaavan SQLSTATE-virheen alkuperäisille tietolähdevirheille. Itse jäljittämilleen virheille ODBC-ohjain ja Ohjaintenhallinta generoivat vastaavan SQLSTATE-virhetilan.

Virhesanoma

ODBC-ohjain näyttää tietolähdevirheiden tapahtuessa virhesanoman, jonka se saa ODBC Tiedostokirjastosta. Kun virhe tapahtuu ODBC-ohjaimessa tai Ohjaintenhallinnassa, ohjain näyttää SQLSTATE-virhetilaan liittyvään tekstiin pohjautuvan virhesanoman.

Virhesanomien esitysmuoto on seuraava:

[toimittaja][ODBC-komponentti][tietolähde]sanoman teksti

jossa hakasulkeissa ([ ]) olevat etuliitteet ilmoittavat virheen sijainnin. Kun virhe tapahtuu Ohjaintenhallinnassa, tietolähdettä ei näytetä. Kun virhe tapahtuu tietolähteessä, [toimittaja]- ja [ODBC-komponentti]-etuliitteet ilmoittavat tietolähdevirheen vastaanottaneen ODBC-komponentin nimen ja sen toimittajan.

Ohjaintenhallinnan ja ohjaimen ISAMin näyttämät virhesanomat on kuvattu seuraavassa:

Virhesanoma:	Virheen sijainti:
[Microsoft][ODBC Driver Manager] sanoman teksti	Ohjaintenhallinta (Odbc32.dll)
[Microsoft][ODBC -ohjaimen nimi][sanoman teksti]	Ohjain-ISAM (katso Ohjain-ISAMit)


SQLGetInfo-funktion palauttamat arvot

Seuraavassa taulukossa on lueteltu fInfoType-argumentin C-kielen #define-direktiivit ja SQLGetInfo-funktion palauttamat vastaavat arvot Nämä tiedot voidaan hakea välittämällä luetellut vakiot SQLGetInfo-funktiokutsun argumenttina. Kun SQLGetInfo-funktio palauttaa 32-bittisen bittimaskin, maskin pystyviiva (|) ilmaisee bitittäisen OR-operaattorin. Lisätietoja SQLGetInfo-funktion palauttamista arvoista on julkaisun Microsoft ODBC Programmer's Reference, Version 2.0 tai uudemman version oppaassa.

SQL_ACCESSIBLE_PROCEDURES

SQL_ACCESSIBLE_TABLES

SQL_ACTIVE_CONNECTIONS

SQL_ACTIVE_ENVIRONMENTS

SQL_ACTIVE_STATEMENTS

SQL_AGGREGATE_FUNCTIONS

SQL_ALTER_DOMAIN

SQL_ALTER_TABLE

SQL_ASYNC_MODE

SQL_BATCH_ROW_COUNT

SQL_BATCH_SUPPORT

SQL_BOOKMARK_PERSISTENCE

SQL_CATALOG_NAME

SQL_COLLATION_SEQ

SQL_COLUMN_ALIAS

SQL_CONCAT_NULL_BEHAVIOR

SQL_CONVERT_BIGINT

SQL_CONVERT_BINARY

SQL_CONVERT_BIT

SQL_CONVERT_CHAR

SQL_CONVERT_DATE

SQL_CONVERT_DECIMAL

SQL_CONVERT_DOUBLE

SQL_CONVERT_FLOAT

SQL_CONVERT_FUNCTIONS

SQL_CONVERT_INTEGER

SQL_CONVERT_LONGVARBINARY

SQL_CONVERT_LONGVARCHAR

SQL_CONVERT_NUMERIC

SQL_CONVERT_REAL

SQL_CONVERT_SMALLINT

SQL_CONVERT_TIME

SQL_CONVERT_TIMESTAMP

SQL_CONVERT_TINYINT

SQL_CONVERT_VARBINARY

SQL_CONVERT_VARCHAR

SQL_CORRELATION_NAME

SQL_CREATE_ASSERTION

SQL_CREATE_CHARACTER_SET

SQL_CREATE_COLLATION

SQL_CREATE_DOMAIN

SQL_CREATE_SCHEMA

SQL_CREATE_TABLE

SQL_CREATE_TRANSLATION

SQL_CREATE_VIEW

SQL_CURSOR_COMMIT_BEHAVIOR

SQL_CURSOR_ROLLBACK_BEHAVIOR

SQL_CURSOR_SENSITIVITY

SQL_DATA_SOURCE_NAME

SQL_DATA_SOURCE_READ_ONLY

SQL_DATABASE_NAME

SQL_DATETIME_LITERALS

SQL_DBMS_NAME

SQL_DBMS_VER

SQL_DDL_INDEX

SQL_DEFAULT_TXN_ISOLATION

SQL_DESCRIBE_PARAMETER

SQL_DRIVER_HDBC

SQL_DRIVER_HENV

SQL_DRIVER_HLIB

SQL_DRIVER_HSTMT

SQL_DRIVER_NAME

SQL_DRIVER_ODBC_VER

SQL_DRIVER_VER

SQL_DROP_ASSERTION

SQL_DROP_CHARACTER_SET

SQL_DROP_COLLATION

SQL_DROP_DOMAIN

SQL_DROP_SCHEMA

SQL_DROP_TABLE

SQL_DROP_TRANSLATION

SQL_DROP_VIEW

SQL_LAUSEKES_IN_ORDERBY

SQL_FETCH_DIRECTION

SQL_FILE_USAGE

SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES1

SQL_GETDATA_EXTENSIONS

SQL_GROUP_BY

SQL_IDENTIFIER_CASE

SQL_IDENTIFIER_QUOTE_CHAR

SQL_KEYWORDS

SQL_LIKE_ESCAPE_CLAUSE

SQL_LOCK_TYPES

SQL_MAX_BINARY_LITERAL_LEN

SQL_MAX_CHAR_LITERAL_LEN

SQL_MAX_COLUMN_NAME_LEN

SQL_MAX_COLUMNS_IN_GROUP_BY

SQL_MAX_COLUMNS_IN_INDEX

SQL_MAX_COLUMNS_IN_ORDER_BY

SQL_MAX_COLUMNS_IN_SELECT

SQL_MAX_COLUMNS_IN_TABLE

SQL_MAX_CURSOR_NAME_LEN

SQL_MAX_INDEX_SIZE

SQL_MAX_OWNER_NAME_LEN

SQL_MAX_PROCEDURE_NAME_LEN

SQL_MAX_QUALIFIER_NAME_LEN

SQL_MAX_ROW_SIZE

SQL_MAX_ROW_SIZE_INCLUDES_LONG

SQL_MAX_-LAUSE_LEN

SQL_MAX_TABLE_NAME_LEN

SQL_MAX_TABLES_IN_SELECT

SQL_MAX_USER_NAME_LEN

SQL_MULT_RESULT_SETS

SQL_MULTIPLE_ACTIVE_TXN

SQL_NEED_LONG_DATA_LEN

SQL_NON_NULLABLE_COLUMNS

SQL_NULL_COLLATION

SQL_NUMERIC_FUNCTIONS

SQL_ODBC_API_ CONFORMANCE

SQL_ODBC_SAG_CLI_ CONFORMANCE

SQL_ODBC_SQL_CONFORMANCE

SQL_ODBC_SQL_OPT_IEF

SQL_ODBC_VER

SQL_OJ_CAPABILITIES

SQL_ORDER_BY_COLUMNS_IN_SELECT

SQL_OUTER_JOINS

SQL_OWNER_TERM

SQL_OWNER_USAGE

SQL_POS_OPERATIONS

SQL_POSITIONED_STATEMENTS

SQL_PROCEDURE_TERM

SQL_PROCEDURES

SQL_QUALIFIER_LOCATION

SQL_QUALIFIER_NAME_SEPARATOR

SQL_QUALIFIER_TERM

SQL_QUALIFIER_USAGE

SQL_QUOTED_IDENTIFIER_CASE

SQL_ROW_UPDATES

SQL_SCROLL_CONCURRENCY

SQL_SCROLL_OPTIONS

SQL_SEARCH_PATTERN_ESCAPE

SQL_SERVER_NAME

SQL_SPECIAL_CHARACTERS

SQL_STATIC_SENSITIVITY

SQL_STRING_FUNCTIONS

SQL_SUBQUERIES

SQL_SYSTEM_FUNCTIONS

SQL_TABLE_TERM

SQL_TIMEDATE_ADD_INTERVALS

SQL_TIMEDATE_DIFF_INTERVALS

SQL_TIMEDATE_FUNCTIONS

SQL_TXN_CAPABLE

SQL_TXN_ISOLATION_OPTION

SQL_UNION

SQL_USER_NAME


SQL_ACCESSIBLE_PROCEDURES

"Y"
(Microsoft Access)

"N"
(dBASE, Microsoft Excel, Paradox, Teksti)


SQL_ACCESSIBLE_TABLES

"Y"


SQL_ACTIVE_CONNECTIONS

64


SQL_ACTIVE_ENVIRONMENTS

0


SQL_ACTIVE_STATEMENTS

0


SQL_AGGREGATE_FUNCTIONS

Kaikki maskin bitit asetettu


SQL_ALTER_DOMAIN

0

(Microsoft Access)


SQL_ALTER_TABLE

SQL_AT_ADD_COLUMN |
SQL_AT_DROP_COLUMN
(dBASE, Paradox)

0
(Microsoft Access, Microsoft Excel, Teksti)


SQL_ASYNC_MODE

0
(Microsoft Access)


SQL_BATCH_ROW_COUNT

0
(Microsoft Access)


SQL_BATCH_SUPPORT

0
(Microsoft Access)


SQL_BOOKMARK_PERSISTENCE

SQL_BP_SCROLL |
SQL_BP_UPDATE (1)

1 Kirjanmerkit pysyvät päivitysten vahvistamisen jälkeen, mutta eivät peruutuksen jälkeen.


SQL_CATALOG_NAME

"Y"


SQL_COLLATION_SEQ

Tyhjä merkkijono


SQL_COLUMN_ALIAS

"Y"


SQL_CONCAT_NULL_BEHAVIOR

SQL_CB_NON_NULL


SQL_CONVERT_BIGINT

0


SQL_CONVERT_BINARY

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_BIT

0


SQL_CONVERT_CHAR

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_DATE

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_DECIMAL

0


SQL_CONVERT_DOUBLE

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_FLOAT

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_FUNCTIONS

SQL_FN_CVT_CONVERT


SQL_CONVERT_INTEGER

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_LONGVARBINARY

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_LONGVARCHAR

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_NUMERIC

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_REAL

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_SMALLINT

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_TIME

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_TIMESTAMP

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_TINYINT

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_VARBINARY

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CONVERT_VARCHAR

SQL_CVT_DOUBLE |
SQL_CVT_FLOAT |
SQL_CVT_INTEGER |
SQL_CVT_NUMERIC |
SQL_CVT_REAL |
SQL_CVT_SMALLINT |
SQL_CVT_VARCHAR |
SQL_CVT_WVARCHAR


SQL_CORRELATION_NAME

SQL_CN_DIFFERENT


SQL_CREATE_ASSERTION

0
(Microsoft Access)


SQL_CREATE_CHARACTER_SET

0
(Microsoft Access)


SQL_CREATE_COLLATION

0
(Microsoft Access)


SQL_CREATE_DOMAIN

0
(Microsoft Access)


SQL_CREATE_SCHEMA

0
(Microsoft Access)


SQL_CREATE_TABLE

TABLE
(Microsoft Access)


SQL_CREATE_TRANSLATION

0
(Microsoft Access)


SQL_CREATE_VIEW

SQL_CV_CREATE_VIEW
(Microsoft Access)


SQL_CURSOR_COMMIT_BEHAVIOR

SQL_CB_CLOSE


SQL_CURSOR_ROLLBACK_BEHAVIOR

SQL_CB_CLOSE


SQL_CURSOR_SENSITIVITY

SQL_UNSPECIFIED


SQL_DATA_SOURCE_NAME

DSN Odbc.ini-tiedostosta tai "", jos Odbc.ini-tiedostossa käytetään DRIVER-avainsanaa.


SQL_DATA_SOURCE_READ_ONLY

"N"
(Microsoft Access, dBASE, Paradox)

"Y"
(Microsoft Excel, Teksti)


SQL_DATABASE_NAME

Tiedoston nimi (Microsoft Access, Microsoft Excel 5.0/7.0//97)

Aktiivisen tietokannan kansio (dBASE, Microsoft Excel 3.0/4.0, Paradox, Teksti)


SQL_DATETIME_LITERALS

0
(Microsoft Access)


SQL_DBMS_NAME

"ACCESS"  (Microsoft Access)
"DBASE"  (dBASE)
"EXCEL"  (Microsoft Excel)
"PARADOX"  (Paradox)
"TEXT"  (Teksti)


SQL_DBMS_VER

ISAM:	Versio:	Versionumeroiden muoto:
Microsoft Access	2.0 3.0 3.5 4.0	02.00.0000 03.00.0000 03.50.0000 04.00.0000 (Versiot 1.0 ja 1.1 eivät ole tuettuja.) (Microsoft Access -versioiden 3.0, 7.0 ja 97 tietojen muodossa ei ole eroa.)
dBASE	3.0 4.0 5.0	03.0n.nnnn 04.0n.nnnn 05.0n.nnnn
Microsoft Excel	3.0 4.0 5.0 7.0, 97	03.0n.nnnn 04.0n.nnnn 05.0n.nnnn 07.0n.nnnn
Paradox	3.x 4.x 5.x	03.nn.nnnn 04.nn.nnnn 05.nn.nnnn
Teksti	1.0	01.0n.nnnn


SQL_DDL_INDEX

CREATE, DROP
(Microsoft Access)


SQL_DEFAULT_TXN_ISOLATION

SQL_TXN_READ_COMMITTED [Microsoft Access]

0 [dBASE, Microsoft Excel, Paradox, Teksti]


SQL_DESCRIBE_PARAMETER

0
(Microsoft Access)


SQL_DRIVER_HDBC

Ohjaintenhallinnan käsittelemä.


SQL_DRIVER_HENV

Ohjaintenhallinnan käsittelemä.


SQL_DRIVER_HLIB

Ohjaintenhallinnan käsittelemä.


SQL_DRIVER_HSTMT

Ohjaintenhallinnan käsittelemä.


SQL_DRIVER_NAME

"OdbcJt32.dll"


SQL_DRIVER_ODBC_VER

"3.51.0000"


SQL_DRIVER_VER

" 4.00.nnnn"  (nnnn määrittää koontikäännöksen päivämäärän.)


SQL_DROP_ASSERTION

0
(Microsoft Access)


SQL_DROP_CHARACTERSET

0
(Microsoft Access)


SQL_DROP_COLLATION

0
(Microsoft Access)


SQL_DROP_DOMAIN

0
(Microsoft Access)


SQL_DROP_SCHEMA

0
(Microsoft Access)


SQL_DROP_TABLE

SQL_DT_DROP_TABLE
(Microsoft Access)


SQL_DROP_TRANSLATION

0
(Microsoft Access)


SQL_DROP_VIEW

SQL_DV_DROP_VIEW
(Microsoft Access)


SQL_EXPRESSIONS_IN_ORDERBY

"Y"


SQL_FETCH_DIRECTION

SQL_FD_FETCH_NEXT |
SQL_FD_FETCH_FIRST |
SQL_FD_FETCH_LAST |
SQL_FD_FETCH_PRIOR |
SQL_FD_FETCH_ABSOLUTE |
SQL_FD_FETCH_RELATIVE |
SQL_FD_FETCH_BOOKMARK


SQL_FILE_USAGE

SQL_FILE_QUALIFIER
(Microsoft Access, Microsoft Excel 5.0, 7.0 tai 97)

SQL_FILE_TABLE
(dBASE, Microsoft Excel 3.0 tai 4.0, Paradox, Teksti)


SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES1

NEXT, LOCK_NO_CHANGE, POS_POSITION, POS_UPDATE
(Microsoft Access)


SQL_GETDATA_EXTENSIONS

SQL_GD_ANY_ORDER |
SQL_GD_ANY_COLUMN |
SQL_GD_BLOCK |
SQL_GD_BOUND


SQL_GROUP_BY

SQL_GB_GROUP_BY_CONTAINS_SELECT


SQL_IDENTIFIER_CASE

SQL_IC_MIXED
(Microsoft Access, Microsoft Excel, Paradox, Teksti)

SQL_IC_UPPER (1)
(dBASE)

1 Tarkenne palautetaan kirjoitusasussa niin, että Windows NT voi paikantaa kansion.


SQL_IDENTIFIER_QUOTE_CHAR

"`" (gravis)


SQL_KEYWORDS

ALPHANUMERIC, AUTOINCREMENT, BINARY, BOOLEAN, BYTE, COUNTER, CURRENCY, DATABASE, DATABASENAME, DATETIME, DISALLOW, DISTINCTROW, DOUBLEFLOAT, FLOAT4, FLOAT8, GENERAL, IEEEDOUBLE, IEEESINGLE, IGNORE, IMAGE, INTEGER1, INTEGER2, INTEGER4, LOGICAL, LOGICAL1, LONG, LONGBINARY, LONGCHAR, LONGTEXT, MEMO, MONEY, NOTE, NUMBER, OLEOBJECT, OWNERACCESS, PARAMETERS, PERCENT, PIVOT, SHORT, SINGLE, SINGLEFLOAT, STDEV, STDEVP, STRING, TABLEID, TEXT, TOP, TRANSFORM, UNSIGNEDBYTE, VAR, VARBINARY, VARP, YESNO


SQL_LIKE_ESCAPE_CLAUSE

"N"


SQL_LOCK_TYPES

SQL_LCK_NO_CHANGE


SQL_MAX_BINARY_LITERAL_LEN

255


SQL_MAX_CHAR_LITERAL_LEN

255  (Microsoft Access)
254  (dBASE)
255  (Microsoft Excel 3.0, 4.0, 5.0, tai 7.0)
65535 (Microsoft Excel 97)
255  (Paradox)
255  (Teksti)


SQL_MAX_COLUMN_NAME_LEN

64  (Microsoft Access)
10  (dBASE)
64  (Microsoft Excel 5.0, 7.0, tai 97)
30  (Microsoft Excel 3.0 tai 4.0)
25  (Paradox)
64  (Teksti)


SQL_MAX_COLUMNS_IN_GROUP_BY

10


SQL_MAX_COLUMNS_IN_INDEX

32  (Microsoft Access)
0  (Rajoitus tuntematon tai ei käytettävissä)  (dBase)
0  (Microsoft Excel)
0  (Rajoitus tuntematon tai ei käytettävissä)  (Paradox)
0  (Teksti)


SQL_MAX_COLUMNS_IN_ORDER_BY

10


SQL_MAX_COLUMNS_IN_SELECT

255


SQL_MAX_COLUMNS_IN_TABLE

255

Käytettäessä Microsoft Excel-ohjainta, CREATE TABLE -lause voi sallia 256 saraketta, mutta 255 sarakkeen rajoitus on kuitenkin voimassa, ja tietojen lisääminen sarakkeeseen 256 ei onnistu.


SQL_MAX_CURSOR_NAME_LEN

64


SQL_MAX_INDEX_SIZE

255  	(Microsoft Access)
220  	(dBASE)
0  	(Microsoft Excel)
1350  	(Paradox)
0  	(Teksti)


SQL_MAX_OWNER_NAME_LEN

0


SQL_MAX_PROCEDURE_NAME_LEN

64  (Microsoft Access)
0  (dBASE)
0  (Microsoft Excel)
0  (Paradox)
0  (Teksti)


SQL_MAX_QUALIFIER_NAME_LEN

66


SQL_MAX_ROW_SIZE

2096  (Microsoft Access)
4000  (dBASE)
65535  (Microsoft Excel)
1350   (Paradox)
65535  (Teksti)


SQL_MAX_ROW_SIZE_INCLUDES_LONG

"N"  (Microsoft Access)
"N"  (dBASE)
"Y"  (Microsoft Excel)
"N"  (Paradox)
"Y"  (Teksti)


SQL_MAX_-LAUSE_LEN

65000


SQL_MAX_TABLE_NAME_LEN

64  (Microsoft Access)
12  (dBASE)
31  (Microsoft Excel 5.0, 7.0, tai 97)
12  (Microsoft Excel 3.0 tai 4.0)
12  (Paradox)
12  (Teksti)


SQL_MAX_TABLES_IN_SELECT

16


SQL_MAX_USER_NAME_LEN

0


SQL_MULT_RESULT_SETS

"N"


SQL_MULTIPLE_ACTIVE_TXN

"Y"


SQL_NEED_LONG_DATA_LEN

"N"


SQL_NON_NULLABLE_COLUMNS

SQL_NNC_NON_NULL


SQL_NULL_COLLATION

SQL_NC_LOW


SQL_NUMERIC_FUNCTIONS

SQL_FN_NUM_ABS |
SQL_FN_NUM_ATAN |
SQL_FN_NUM_CEILING |
SQL_FN_NUM_COS |
SQL_FN_NUM_EXP |
SQL_FN_NUM_FLOOR |
SQL_FN_NUM_LOG |
SQL_FN_NUM_MOD |
SQL_FN_NUM_POWER |
SQL_FN_NUM_RAND |
SQL_FN_NUM_SIGN |
SQL_FN_NUM_SIN |
SQL_FN_NUM_SQRT |
SQL_FN_NUM_TAN


SQL_ODBC_API_CONFORMANCE

SQL_OAC_LEVEL1


SQL_ODBC_SAG_CLI_CONFORMANCE

SQL_OSCC_ COMPLIANT


SQL_ODBC_SQL_CONFORMANCE

SQL_OSC_MINIMUM


SQL_ODBC_SQL_OPT_IEF

"N"


SQL_ODBC_VER

Ohjaintenhallinnan palauttama arvo.


SQL_OJ_CAPABILITIES

SQL_OJ_LEFT
SQL_OJ_RIGHT
SQL_OJ_NOT_ORDERED
SQL_OJ_INNER
SQL_OJ_ALL_COMPARISON_OPS


SQL_ORDER_BY_COLUMNS_IN_SELECT

"N"


SQL_OUTER_JOINS

"Y"


SQL_OWNER_TERM

""


SQL_OWNER_USAGE

0


SQL_POS_OPERATIONS

SQL_POS_POSITION |
SQL_POS_REFRESH |
SQL_POS_UPDATE |
SQL_POS_DELETE |
SQL_POS_ADD
(Microsoft Access, dBASE, Paradox)

SQL_POS_POSITION |
SQL_POS_REFRESH
(Microsoft Excel, Teksti)


SQL_POSITIONED_STATEMENTS

0


SQL_PROCEDURE_TERM

"QUERY"
(Microsoft Access)

""
(dBASE, Microsoft Excel, Paradox, Teksti)


SQL_PROCEDURES

"Y"
(Microsoft Access)

"N"
(dBASE, Microsoft Excel, Paradox, Teksti)


SQL_QUALIFIER_LOCATION

SQL_QL_START


SQL_QUALIFIER_NAME_SEPARATOR

"."
(Microsoft Access, Microsoft Excel 5.0, 7.0 tai 97)

"\"
(dBASE, Microsoft Excel 3.0 tai 4.0, Paradox, Teksti)


SQL_QUALIFIER_TERM

"Database"  (Microsoft Access)
"Directory"  (dBASE)
"Workbook"  (Microsoft Excel 5.0, 7.0, tai 97)/
"Directory" (Microsoft Excel 3.0 tai 4.0)
"Directory"  (Paradox)
"Directory"  (Teksti)


SQL_QUALIFIER_USAGE

SQL_QU_DML_STATEMENTS |
SQL_QU_TABLE_DEFINITION |
SQL_QU_INDEX_DEFINITION |
SQL_QU_PROCEDURE_INVOCATION
(Microsoft Access)

SQL_QU_DML_STATEMENTS |
SQL_QU_TABLE_DEFINITION |
SQL_QU_INDEX_DEFINITION
(dBASE, Paradox)

SQL_QU_DML_STATEMENTS |
SQL_QU_TABLE_DEFINITION
(Microsoft Excel, Teksti)


SQL_QUOTED_IDENTIFIER_CASE

SQL_IC_MIXED


SQL_ROW_UPDATES

"N"


SQL_SCROLL_CONCURRENCY

SQL_SCCO_READ_ONLY |
SQL_SCCO_LOCK |
SQL_SCCO_OPT_VALUES
(Microsoft Access, dBASE, Paradox)

SQL_SCCO_READ_ONLY
(Microsoft Excel, Teksti)


SQL_SCROLL_OPTIONS

SQL_SO_FORWARD_ONLY |
SQL_SO_STATIC |
SQL_SO_KEYSET_DRIVEN


SQL_SEARCH_PATTERN_ESCAPE

"\"


SQL_SERVER_NAME

"ACCESS"  (Microsoft Access)
"DBASE"  (dBASE)
"EXCEL"  (Microsoft Excel)
"PARADOX"  (Paradox)
"TEXT"  (Teksti)


SQL_SPECIAL_CHARACTERS

"~`@#$%^&*_-+=\}{"';:?/><,.!'[]|"


SQL_STATIC_SENSITIVITY

SQL_SS_ADDITIONS |
SQL_SS_DELETIONS |
SQL_SS_UPDATES


SQL_STRING_FUNCTIONS

SQL_FN_STR_ASCII |
SQL_FN_STR_CHAR |
SQL_FN_STR_CONCAT |
SQL_FN_STR_LCASE |
SQL_FN_STR_LEFT |
SQL_FN_STR_LENGTH |
SQL_FN_STR_LOCATE |
SQL_FN_STR_LOCATE_2
SQL_FN_STR_LTRIM |
SQL_FN_STR_RIGHT |
SQL_FN_STR_RTRIM |
SQL_FN_STR_SPACE |
SQL_FN_STR_SUBSTRING |
SQL_FN_STR_UCASE


SQL_SUBQUERIES

SQL_SQ_COMPARISON |
SQL_SQ_EXISTS |
SQL_SQ_IN |
SQL_SQ_QUANTIFIED |
SQL_SQ_CORRELATED_SUBQUERIES


SQL_SYSTEM_FUNCTIONS

0


SQL_TABLE_TERM

"TABLE"


SQL_TIMEDATE_ADD_INTERVALS

0


SQL_TIMEDATE_DIFF_INTERVALS

0


SQL_TIMEDATE_FUNCTIONS

SQL_FN_TD_CURDATE |
SQL_FN_TD_CURTIME |
SQL_FN_TD_DAYOFMONTH |
SQL_FN_TD_DAYOFWEEK |
SQL_FN_TD_DAYOFYEAR |
SQL_FN_TD_HOUR |
SQL_FN_TD_MINUTE |
SQL_FN_TD_MONTH |
SQL_FN_TD_NOW |
SQL_FN_TD_SECOND |
SQL_FN_TD_WEEK |
SQL_FN_TD_YEAR
(Microsoft Access, Microsoft Excel, Teksti)

SQL_FN_TD_DAYOFMONTH |
SQL_FN_TD_DAYOFWEEK |
SQL_FN_TD_DAYOFYEAR |
SQL_FN_TD_HOUR |
SQL_FN_TD_MINUTE |
SQL_FN_TD_MONTH |
SQL_FN_TD_SECOND |
SQL_FN_TD_WEEK |
SQL_FN_TD_YEAR
(dBASE, Paradox)


SQL_TXN_CAPABLE

SQL_TC_ALL
(Microsoft Access)

SQL_TC_NONE
(dBASE, Microsoft Excel, Paradox, Teksti)


SQL_TXN_ISOLATION_OPTION

SQL_TXN_READ_COMMITTED
(Microsoft Access)

0
(dBASE, Microsoft Excel, Paradox, Teksti)


SQL_UNION

SQL_U_UNION_ALL |
SQL_U_UNION


SQL_USER_NAME

Ei tuettu


Tuetut ODBC API-funktiot

Microsoft ODBC-ohjaimet tukevat kaikkia ydintason funktioita ja tason 1 funktioita sekä seuraavia tason 2 funktioita:

•	SQLDataSources

•	SQLDrivers

•	SQLExtendedFetch

•	SQLMoreResults

•	SQLNativeSQL

•	SQLNumParams

•	SQLProcedures

•	SQLProcedureColumns

•	SQLSetPos

•	SQLSetScrollOptions


SQLBindParameter

Jos Microsoft Excel -ohjainta käytettäessä suoritetaan INSERT-lause, joka lisää NULL-arvon SQL_CHAR-sarakkeeseen parametrin avulla, ohjelma palauttaa SQL_SUCCESS_WITH_INFO-koodin ja SQLSTATE 01004 -virheilmoituksen, joka ilmoittaa, että järjestelmä on katkaissut tiedot.


SQLColAttributes

Määrite:	Kommentit:
SQL_COLUMN_DISPLAY_SIZE	LONGVARBINARY-tietotyypin sarakkeen enimmäispituuden arvo on SQL_COLUMN_DISPLAY_SIZE, ei sarakkeen enimmäispituus kerrottuna kahdella.
SQL_COLUMN_MONEY	Ohjelma palauttaa arvon FALSE sarakkeelle, jonka tietotyyppi on  Paradox-tietotyyppi CURRENCY. Tämä tietotyyppi vastaa ODBC SQL -tietotyyppiä SQL_DOUBLE.
SQL_OWNER_NAME	Tähän sarakkeeseen palautetaan tyhjä merkkijono (“”), koska omistajan  nimeä ei tueta.
SQL_QUALIFIER_NAME	Käytettäessä Microsoft Access -tietolähdettä tietokantatiedoston polku palautetaan, käytettäessä dBASE-, Microsoft Excel-,  Paradox- tai Teksti-tietolähdettä kansion polku palautetaan.
SQL_COLUMN_SEARCHABLE	LONGVARBINARY- ja LONGVARCHAR-sarakkeet saavat arvon SQL_UNSEARCHABLE. Kiinteämittaisia sekä vaihtuvamittaisia binaari- ja merkkimuotoisia tietotyyppejä voidaan etsiä, vaikka LONGVARBINARY- ja LONGVARCHAR- tietotyyppejä ei voi etsiä.
Huomautus: yllä olevassa luettelossa ei ole kaikkia SQLColAttributes-funktion palauttamia määritteitä.


SQLColumns

Sarake	Kommentit
TABLE_QUALIFIER	Käytettäessä Microsoft Access -ohjainta tietokantatiedoston polku palautetaan, käytettäessä dBASE-, Microsoft Excel-, Paradox- tai Teksti-ohjainta kansion polku palautetaan.
TABLE_OWNER	Tähän sarakkeeseen palautetaan NULL-arvo, koska omistajan nimeä ei tueta.
NULLABLE	Sarakkeille, joilla on perusavain tai yksilöllinen indeksi, palautetaan SQL_NO_NULLS-arvo.


SQLConfigDataSource

Katso myös

SQLConfigDataSource-funktio, jonka avulla voit lisätä, muokata tai poistaa tietolähteitä suorituksen aikana, käyttää seuraavassa kuvattuja avainsanoja:

Avainsana	Kuvaus
CHARACTERSET	Teksti-ohjainta käytettäessä joko OEM tai ANSI.
COLLATINGSEQUENCE	Kenttien lajittelujärjestys. dBASE-ohjainta käytettäessä järjestys voi olla ASCII (oletusarvo) tai kansainvälinen. Paradox-ohjainta käytettäessä järjestys voi olla ASCII (oletusarvo), Kansainvälinen, suomi-ruotsi tai norja-tanska. Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Lajittelujärjestys-ruutu.
COLNAMEHEADER	Osoittaa Teksti-ohjainta käytettäessä, käytetäänkö taulukon ensimmäisen tietueen arvoja sarakkeiden niminä. Arvo voi olla TRUE tai FALSE.
COMPACT_DB	Microsoft Access -ohjainta käytettäessä suorittaa tietokantatiedoston tietojen uudelleenjärjestämisen. Muoto on seuraava: COMPACT_DB=<polku_nimi><valinnainen _lajittelu_järjestys><valinnainen ENCRYPT-avainsana>.
CREATE_DB	Luo tietokantatiedoston käytettäessä Microsoft Access -ohjainta. Muoto on seuraava: CREATE_DB=<polku><valinnainen lajittelujärjestys>, missä polku on Microsoft Access -tietokannan täydellinen polunnimi. Ohjelma palauttaa virheen, jos polku määrittää olemassa olevan tietokannan. Lajittelujärjestys on sama kuin Uusi tietokanta -valintaikkunan lajittelujärjestys. Ikkuna tulee näkyviin valittaessa Microsoft Accessin asennus -valintaikkunan Luo-painike. Jos lajittelujärjestystä ei määritetä, ohjelma käyttää yleistä lajittelujärjestystä.  Jos CREATE_DB-avainsanan avulla luotavan Microsoft Access -tietokannan nimessä on välilyöntejä, koko polku on kirjoitettava lainausmerkkeihin, kuten seuraavissa esimerkeissä: "C:\OHJELMATIEDOSTOT\YHTEISET TIEDOSTOT\ OmaAccess.mdb" CREATE_DB=C:\TEMP\testi.mdb (lainausmerkkejä ei tarvita).
CREATE_SYSDB	Luo järjestelmätietokannan käytettäessä Microsoft Access -ohjainta. Muoto on seuraava: CREATE_SYSDB=<polku><valinnainen_lajittelujärjestys>, missä polku on Microsoft Access -tietokannan täydellinen polunnimi. Ohjelma palauttaa virheen, jos polku määrittää jo luodun tietokannan. Lajittelujärjestys on sama kuin Uusi tietokanta -valintaikkunan lajittelujärjestys. Ikkuna tulee näkyviin valittaessa Microsoft Access Asennus -valintaikkunan Luo-painike. Jos lajittelujärjestystä ei määritetä, ohjelma käyttää yleistä lajittelujärjestystä.
CREATE_V2DB	Luo Microsoft Access version 2.0 kanssa yhteensopivan tietokantatiedoston käytettäessä Microsoft Access -ohjainta. Muoto on seuraava: CREATE_V2DB=<polku><valinnainen lajittelujärjestys>, missä polku on Microsoft Access -tietokannan täydellinen polunnimi. Ohjelma palauttaa virheen, jos polku määrittää olemassa olevan tietokannan. Lajittelujärjestys on sama kuin Uusi tietokanta -valintaikkunan lajittelujärjestys, joka tulee näkyviin valittaessa Microsoft Accessin asennus -valintaikkunan Luo-painike. Jos lajittelujärjestystä ei määritetä, ohjelma käyttää yleistä lajittelujärjestystä. Jos CREATE_V2DB-avainsanan avulla luotavan Microsoft Access -tietokannan polussa on välilyöntejä, koko polku on kirjoitettava lainausmerkkeihin, kuten seuraavissa esimerkeissä:"C:\OHJELMATIEDOSTOT\YHTEISET TIEDOSTOT\ OmaAccess.mdb" CREATE_V2DB=C:\TEMP\testi.mdb (lainausmerkkejä ei tarvita).
DBQ	Microsoft Access- tai Paradox-ohjainta käytettäessä tietokantatiedoston nimi. Microsoft Excel -ohjainta ja Microsoft Excel 5.0/7.0/97 -tiedostoja käytettäessä työkirjatiedoston nimi. Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Tietokanta-ohjausobjekti.
DEFAULTDIR	Määrittää tietokantatiedoston polun (käytettäessä Microsoft Access -ohjainta) tai kansion polun (käytettäessä dBASE-, Microsoft Excel-, Paradox- tai Teksti-ohjainta).  Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Valitse kansio -ohjausobjekti, ja Microsoft Excel -ohjainta käytettäessä saman vaihtoehdon kuin Asennus-valintaikkunan Valitse työkirja -ohjausobjekti.
DELETED	Määrittää käytettäessä dBASE- -ohjainta, voidaanko poistetuiksi merkityt rivit palauttaa tai voidaanko niihin siirtyä. Jos arvoksi asetetaan 1, poistettuja rivejä ei näytetä; jos arvoksi asetetaan 0, poistettuja rivejä käsitellään samoin kuin poistamattomia rivejä. Oletusarvon mukaan poistettuja rivejä ei näytetä.  Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Näytä poistetut rivit -ohjausobjekti.
DESCRIPTION	Kuvaus tietolähteen tiedoista.Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Kuvaus-ohjausobjekti.
DRIVER	Määrittää ohjaimen DLL-tiedoston polun
DRIVERID	Ohjaimen tunnusluku.   25 (Microsoft Access)   21 (dBASE III)   277 (dBASE IV)   533 (dBASE 5.0)   534 (Microsoft Excel 3.0)   278 (Microsoft Excel 4.0)   22 (Microsoft Excel 5.0/7.0)   790 (Microsoft Excel 97)   26 (Paradox 3.x)   282 (Paradox 4.x)   538 (Paradox 5.x)   27 (Teksti)
EXCLUSIVE	Määrittää, avaako ohjelma tietokannan "Yksityinen"-tilassa (tietokantaa voi käyttää vain yksi käyttäjä kerrallaan) vai jaetussa tilassa (tietokantaa voi käyttää useita käyttäjiä samanaikaisesti). Arvo voi olla TRUE ("Yksityinen"-tila) tai FALSE ("Jaettu"-tila). (Tämä ei koske Microsoft Excel- ja Teksti-ohjaimia.) Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Yksityinen-ohjausobjekti.
EXTENSIONS	Luettelee tietolähteen Teksti-tiedostojen tunnisteet.  Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Tunnisteluettelo-ohjausobjekti.
FIL	Tiedostotyyppi.     MS Access käytettäessä Microsoft Accessia    dBase III, dBase IV tai dBase 5    Excel 3.0, 4.0, 5.0, 7.0 tai 97 käytettäessä Microsoft        Exceliä    Paradox 3.x, 4.x tai 5.x)    Teksti.
FILETYPE	Teksti-ohjaimen tiedostotyyppi (Teksti).
FIRSTROWHASNAMES	Määrittää Microsoft Excel -ohjainta käytettäessä, ovatko taulukon sarakkeiden nimet arvoalueen ensimmäisen rivin soluissa (1) vai eivät (0).
FORMAT	Voi olla FIXEDLENGTH, TABDELIMITED, CSVDELIMITED (erottimena pilkku) tai DELIMITED() (erotinmerkki määritetty sulkeissa) käytettäessä Teksti-ohjainta. Erikoismerkki on yhden merkin pituinen merkki, joka voi olla kirjain tai kymmenjärjestelmän tai heksadesimaalijärjestelmän luku.
IMPLICITCOMMITSYNC	Määrittää, vahvistaako Microsoft Access -ohjain sisäiset tai implisiittiset tapahtumasarjat synkronisesti vai asynkronisesti. Oletusarvo on "Kyllä", mikä merkitsee, että Microsoft Access -ohjain odottaa, että sisäiset tai implisiittiset tapahtumasarjat suoritetaan loppuun.  Tämän vaihtoehdon arvoa ei tulisi muuttaa harkitsematta tarkoin mahdollisia seurauksia. Lisätietoja vaihtoehdosta on julkaisussa Microsoft Jet Database Engine Programmers’s Guide.Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan ImplicitCommitSync-ohjausobjekti.
MAXBUFFERSIZE	Määrittää kilotavuina sen sisäisen puskurin koon, jota Microsoft Access käyttää siirtäessään tietoja muistista levylle ja levyltä muistiin. Oletuspuskurikoko on 512 kilotavua (ilmaistaan muodossa 512). Mikä tahansa 256:lla jaollinen kokonaisluku kelpaa puskurikoon arvoksi. Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Puskurin koko -ohjausobjekti.
MAXSCANROWS	Tarkistettavien rivien määrä määritettäessä sarakkeiden tietotyyppejä taulukon tietojen perusteella. Toimintoa voidaan käyttää Microsoft Access-, Microsoft Excel- tai Teksti-ohjainta käytettäessä.Tarkistettavien rivien määräksi voidaan asettaa 1 - 16. Oletusarvo on 8; jos arvoksi asetetaan 0, kaikki rivit tarkistetaan. (Sallittuun alueeseen kuulumaton arvo aiheuttaa virheen.)  Käytettäessä Teksti-ohjainta voit antaa tarkistettavien rivien määräksi 1 - 32767, mutta oletusarvoksi tulee aina 25. (Sallittuun alueeseen kuulumaton arvo aiheuttaa virheen.)  Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Läpikäytävät rivit -ohjausobjekti.
PAGETIMEOUT	Määrittää sekunnin kymmenesosina ajanjakson, jonka sivu (jos sitä ei käytetä) säilyy puskurissa, ennen kuin se poistetaan. Käytettäessä Microsoft Access -ohjainta oletusarvo on 5 sekunnin kymmenesosaa (0,5 sekuntia). Käytettäessä dBASE-  ja Paradox-ohjaimia oletusarvo on 600 sekunnin kymmenesosaa (60 sekuntia). Ota huomioon, että tämä asetus vaikuttaa kaikkiin ODBC-ohjainta käyttäviin tietolähteisiin.  Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Sivun aikakatkaisu -ohjausobjekti.
PARADOXNETPATH	Käytettäessä Paradox-ohjainta Paradox-lukitustietokannan sisältävän kansion koko polku, koska kansio sisältää joko Pdoxusrs.net-tiedoston (Paradox 4.x) tai Paradox.net-tiedoston (Paradox 5.x). Jos kansiossa ei ole kumpaakaan tiedostoa, Paradox-ohjain luo jommankumman niistä. Saat lisätietoja näistä tiedostoista Paradoxin ohjeista. Voit valita verkkokansion vasta, kun olet antanut Paradox-käyttäjätunnuksen.  Tämä määrittää saman asetuksen kuin Paradoxin asennus -valintaikkunan Valitse verkkokansio -ohjausobjekti.
PARADOXNETSTYLE	Käytettäessä Paradox-tietoja Paradox-ohjaimen avulla verkkolaji on joko “3.x” käytettäessä Paradox versiota 3.x tai “4.x” käytettäessä Paradox versioita 4.x ja 5.x. Verkkolajiksi voidaan asettaa “3.x” tai “4.x”, jos Paradox versio on 4.x tai 5.x; jos käytettävä Paradox versio on 3.x, verkkolajin on oltava “3.x”.  Tämä määrittää saman asetuksen kuin Paradoxin asennus -valintaikkunan Verkkolaji-ohjausobjekti.
PARADOXUSERNAME	Paradox-käyttäjätunnus käytettäessä Paradox-ohjainta.  Tämä määrittää saman asetuksen kuin Paradoxin asennus -valintaikkunan Käyttäjätunnus-ohjausobjekti.
PWD	Microsoft Access- tai Paradox-ohjaimen salasana. Tämä on valinnainen salasana käytettäessä Paradox-ohjainta, eikä ohjain kirjoita sitä koskaan tiedostoon. Tätä käytetään kutsuttaessa SQLDriverConnect-funktiota salasanalla suojattuja Paradox-tiedostoja varten.
READONLY	Määrittää tiedoston vain luku -tiedostoksi, kun arvo on TRUE; kun arvo on FALSE, tiedosto ei ole vain luku -tiedosto.  Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Vain luku -ohjausobjekti.
REPAIR_DB	Microsoft Access -ohjainta käytettäessä korjaa tietokannan, joka on vioittunut päivityksen vahvistamisen aikana.
STATISTICS	Määrittää dBASE- ohjainta käytettäessä, arvioidaanko taulukon rivien määrä. Tämä asetus vaikuttaa kaikkiin ODBC-ohjaimia käyttäviin tietolähteisiin.  Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Rivimääräarvio-ohjausobjekti.
SYSTEMDB	Määrittää järjestelmätietokannan polun käytettäessä Microsoft Access -ohjainta.  Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Järjestelmätietokanta-ohjausobjekti.
THREADS	Moduulin käyttämien taustasäikeiden määrä. Microsoft Access -ohjainta käytettäessä oletusarvo on 3, mutta sitä voidaan muuttaa. Käytettäessä dBASE-, Microsoft Excel-, Paradox- ja Teksti-ohjaimia tämä arvo on 3, eikä sitä voi muuttaa.  Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan Säikeet-ohjausobjekti.
UID	Sisäänkirjautumiseen tarvittava käyttäjätunnus käytettäessä Microsoft Access -ohjainta.
USERCOMMITSYNC	Määrittää, suorittaako Microsoft Access -ohjain käyttäjän määrittämät tapahtumasarjat synkronisesti vai asynkronisesti. Oletusarvo on 1, mikä merkitsee, että Microsoft Access -ohjain odottaa, kunnes käyttäjän määrittämän tapahtumasarjan vahvistukset on suoritettu loppuun.  Tätä asetusta ei tulisi muuttaa harkitsematta tarkoin mahdollisia seurauksia.  Lisätietoja vaihtoehdosta on julkaisussa Microsoft Jet Database Engine Programmers’s Guide. Tämä määrittää saman asetuksen kuin Asennus-valintaikkunan UserCommitSync-ohjausobjekti.


SQLDriverConnect

Katso myös

SQLDriverConnect-funktion avulla voit muodostaa yhteyden ohjaimeen luomatta tietolähdettä (DSN:ää).

Kaikkien ohjaimien yhteysmerkkijonossa tuetaan seuraavia avainsanoja: DSN, DBQ ja FIL.

Microsoft Access -ohjain tukee myös UID- ja PWD-avainsanoja. Paradox-ohjain tukee myös PWD-avainsanaa.

Käytettäessä Microsoft Access- tai Paradox-ohjainta, PWD-avainsanassa ei saa olla erikoismerkkejä (katso SQL_SPECIAL_CHARACTERS SQLGetInfo-funktion palauttamat arvot).

Paradox-ohjainta käytettäessä ohjelma varaa salasanalla suojatun tiedoston käyttäjälle, joka sen on avannut. Tällöin muut käyttäjät eivät voi käyttää tiedostoa.

Alla luetellaan avainsanat, jotka välttämättä tarvitaan yhteyden muodostamiseen ohjaimeen, sekä annetaan esimerkkejä SQLDriverConnect-funktion kanssa käytetyistä avainsana- ja arvopareista. DRIVERID-arvojen täydellinen luettelo on ohjeaiheessa SQLConfigDataSource.

Huomautus   Jos DBQ- tai DefaultDir-avainsanoja ei ole määritetty käytettäessä dBASE-, Microsoft Excel 3.0/4.0-, Paradox- tai Teksti-ohjaimia, ohjain muodostaa yhteyden nykyiseen kansioon

Ohjain:	Vaaditut avainsanat:	Esimerkkejä:
Microsoft Access	Driver, DBQ	Driver={Microsoft Access Driver (*.mdb)}; DBQ=c:\temp\sample.mdb
dBASE	Driver, DriverID	Driver={Microsoft dBASE Driver (*.dbf)}; DBQ=c:\temp; DriverID=277
Microsoft Excel 3.0 tai 4.0	Driver, DriverID	Driver={Microsoft Excel Driver (*.xls)}; DBQ=c:\temp; DriverID=278
Microsoft Excel 5.0/7.0	Driver, DriverID,  DBQ	Driver={Microsoft Excel Driver (*.xls)}; DBQ=c:\temp\sample.xls; DriverID=22
Microsoft Excel 97	Driver, DriverID,  DBQ	Driver={Microsoft Excel Driver (*.xls)}; DBQ=c:\temp\sample.xls; DriverID=790
Paradox	Driver, DriverID	Driver={Microsoft Paradox Driver (*.db )}; DBQ=c:\temp;DriverID=26
Teksti	Driver	Driver={Microsoft Text Driver (*.txt;*.csv)}; DefaultDir=c:\temp


SQLGetCursorName

SQLGetCursorName-funktiota tuetaan, mutta sitä voidaan käyttää vain, kun kohdistinkirjasto on käytössä, koska ohjain ei tue kohdistettuja toimintoja.


SQLGetData

Tällä funktiolla voidaan hakea tietoja kaikista sarakkeista riippumatta hakemisjärjestyksestä ja siitä, onko sarakkeen jäljessä sidottuja sarakkeita.


SQLGetInfo

SQLGetInfo-funktio tukee SQL_FILE_USAGE-tietotyyppiä. Funktion palauttama arvo on 16-bittinen kokonaisluku, joka ilmaisee, miten ohjain käsittelee tietolähteen tiedostoja.

SQL_FILE_NOT_SUPPORTED = Ohjain ei ole Single-Tier-ohjain.

SQL_FILE_TABLE = Single-Tier-ohjain käsittelee tietolähteen tiedostoja taulukkoina.

SQL_FILE_QUALIFIER = Single-Tier-ohjain käsittelee tietolähteen tiedostoa tietokantana.

ODBC-ohjain palauttaa arvon SQL_FILE_QUALIFIER käytettäessä Microsoft Access -ohjainta, koska kukin tiedosto on kokonainen tietokanta. ODBC-ohjain palauttaa arvon SQL_FILE_TABLE käytettäessä dBASE-, Microsoft Excel-, Paradox- tai Teksti-ohjainta, koska kukin tiedosto on taulukko.


SQLGetStmtOption

fOption-argumentin SQL_GETBOOKMARK palauttamat kirjanmerkit kelpaavat vain kyselyn ollessa avoinna, ja ne hylätään uusintakyselyn yhteydessä. Pysyviä kirjanmerkkejä ei tueta.


SQLGetTypeInfo

SQLGetTypeInfo-funktion tuottamaan taulukkoon palautettu tyypin nimi (TYPE_NAME) on tietolähteen yleisimmin käyttämä nimi.

SQL_ALL_EXCEPT_LIKE-arvo palautetaan SEARCHABLE-sarakkeeseen Byte-, Counter-, Double-, Single-, Long- ja Short-tietotyypin sarakkeille. (LIKE-vertailua voidaan käyttää muuntamalla arvo merkiksi ODBC-muuntosääntöjen mukaan ja suorittamalla sitten vertailu.)

Käytettäessä Microsoft Excel -ohjainta SQLGetTypeInfo-funktio palauttaa TYPE_NAME-sarakkeeseen ODBC-tyyppien nimet.

Käytettäessä Teksti-ohjainta SQLGetTypeInfo-funktio palauttaa CASE_SENSITIVE-arvon FALSE tekstitietotyypeille (CHAR- ja LONGCHAR-tietotyypeille), vaikka tietotyypeissä itse asiassa erotetaan pienet ja isot kirjaimet toisistaan.


SQLMoreResults

Tämä funktio palauttaa aina arvon SQL_NO_DATA_FOUND.


SQLPrepare

Lause, jossa on määritetty virheellinen sarakkeiden määrä, aiheuttaa virheen vasta suoritusvaiheessa, ei lauseen muodostamisvaiheessa.


SQLProcedureColumns

Tuetaan vain Microsoft Access -tietolähteitä käytettäessä.

Sovelluksen kehittäjien tulisi etsiä ohjaimen määrittämiä sarakkeita aloittaen tulosjoukon lopusta ja siirtyen taaksepäin.

Sarake:	Kommentit:
COLUMN_TYPE	SQL_PARAM_INPUT tai SQL_RESULT_COL
ORDINAL	Tämä on ohjainkohtainen sarake, joka palautetaan tulosjoukon loppuun. Sarakkeen SQL-tietotyyppi on Integer.


SQLProcedures

SQLProcedures-funktio palauttaa rivit vain niille toimintosarjoille, joissa on vähintään yksi argumentti. Argumentittomia toimintosarjoja käsitellään näkyminä.

Sarake:	Kommentit:
PROCEDURE_QUALIFIER	Tietokantatiedoston polku.
PROCEDURE_OWNER	NULL
PROCEDURE_NAME	Toimintosarjan nimi ilman erottimia.
PROCEDURE_TYPE	SQL_PT_PROCEDURE


SQLSetConnectOption

fOption	Kommentti:
SQL_ACCESS_MODE	fOption-argumentin SQL_ACCESS_MODE arvoksi voidaan asettaa joko SQL_MODE_READ_ONLY tai SQL_MODE_READ_WRITE. Ohjain ei kuitenkaan estä päivityksiä, vaikka SQL_ACCESS_MODE-arvoksi olisi asetettu SQL_MODE_READ_ONLY.
SQL_AUTOCOMMIT	Käytettäessä Microsoft Access -ohjainta SQL_AUTOCOMMIT-vaihtoehdon arvoksi voidaan asettaa joko SQL_AUTOCOMMIT_ON tai SQL_AUTOCOMMIT_OFF, koska Microsoft Access -ohjain tukee tapahtumasarjoja(1). dBASE-, Microsoft Excel-, Paradox- ja Teksti-ohjaimet tukevat vain SQL_AUTOCOMMIT-arvoa ON (oletustila), koska ne eivät tue tapahtumasarjoja.
SQL_CURRENT_QUALIFIER	Tuettu.
SQL_LOGIN_TIMEOUT	Ei tuettu.
SQL_OPT_TRACE	Tuettu.
SQL_OPT_TRACEFILE	Tuettu.
SQL_PACKET_SIZE	Ei tuettu.
SQL_QUIET_MODE	Ei tuettu.
SQL_TRANSLATE_DLL	Ei tuettu.
SQL_TRANSLATION_OPTION	Ei tuettu.
SQL_TXN_ISOLATION	Käytettäessä Microsoft Access -ohjainta SQL_TXN_ISOLATION-arvo on aina SQL_TXN_READ_COMMITTED. Muut ohjaimet eivät tue tätä fOption-vaihtoehtoa.

1	Microsoft Access -ohjain ei tue atomisia tapahtumasarjoja. Kun tapahtumasarja vahvistetaan käytettäessä Microsoft Access -ohjainta, tapahtumasarjan vahvistamisen ja arvojen levylle kirjoittamisen välille jää äärellinen viive, jonka Microsoft Jet -moduulin luontainen viive määrittää. Sivun aikakatkaisun viive ei voi olla minimiarvoa pienempi, vaikka Sivun aikakatkaisu -vaihtoehto olisi asetettu viivettä arvoa pienemmäksi. Tästä seuraa, että ei ole mitään takuita siitä, että vahvistetut tiedot olisivat vakaita, koska viiveen aikana niihin voidaan tehdä muutoksia.


SQLSetCursorName

Ohjain ei tue WHERE CURRENT OF kohdistimen-nimi -syntaksin avulla määritettyä kohdistettua päivitystä tai poistoa. Itse SQLSetCursorName-funktiota tuetaan, mutta sitä ei voi käyttää kohdistettujen päivitysten tekemiseen. Funktiota voidaan käyttää vain, kun kohdistinkirjasto on käytössä ja sovellus käyttää SQLExtendedFetch-funktiota.


SQLSetPos

Joukkopäivityksen yhteydessä tuetaan SQLSetPos-kutsuja, joiden irow-argumentin arvo on 0.

fLock-argumenttia SQL_LOCK_NO_CHANGE tuetaan. SQL_LOCK_EXCLUSIVE- ja SQL_LOCK_UNLOCK-vaihtoehtoja ei tueta.

SQLSetPos-funktio tukee päivitettäviä liitoksia. (Lisätietoja on julkaisussa Microsoft Jet Database Engine Programmers’s Guide.)


SQLSetScrollOptions

Eteenpäin vieviä ja staattisia kohdistimia tuetaan vain, kun fConcurrency-argumentin arvo on SQL_CONCUR_READ_ONLY.

fConcurrency-argumentin arvoa SQL_CONCUR_LOCK voidaan käyttää vain avainsarjaperusteisiin kohdistimiin.

fConcurrency-argumentin arvoa SQL_CONCUR_ROWVER ei tueta.

Dynaamisia ja sekamuotoisia kohdistimia ei tueta.


SQLSetStmtOption

fOption	Kommentit
SQL_ASYNC_ENABLE	Asynkronista käsittelyä ei tueta. fOption-argumentin arvo SQL_ASYNC_ENABLE palauttaa SQLSTATE S1C00 -virhekoodin ("ohjain ei tue toimintoa").
SQL_KEYSET_SIZE	Avainsarjan ainoa kelvollinen koko on 0, koska sekamuotoisia ja dynaamisia kohdistimia ei tueta. Jos arvoksi asetetaan jokin toinen luku, se muutetaan 0:ksi ja kutsu palauttaa SQL_SUCCESS_WITH_INFO- ja SQLSTATE 01S02 -koodit. ("vaihtoehdon arvoa on muutettu").
SQL_MAX_ROWS	Tietuesarjan ainoa kelvollinen koko on 0, koska Desktop Database -ohjaimet eivät tue palautettujen rivien määrän rajoittamista. Jos arvoksi asetetaan jokin toinen luku, se muutetaan 0:ksi ja kutsu palauttaa SQL_SUCCESS_WITH_INFO- ja SQLSTATE 01S02 -virhekoodit. ("vaihtoehdon arvoa on muutettu").
SQL_QUERY_TIMEOUT	Ei tuettu.
SQL_ROW_NUMBER	Ei tuettu.
SQL_SIMULATE_CURSOR	Ei tuettu.


SQLSpecialColumns

fColType-argumentin SQL_BEST_ROWID-arvo palauttaa yksilöllisen indeksin (jos sellainen on olemassa). SQL_ROWVER-arvo ei palauta tulosjoukkoa.

Kaikkien rivitunnuksien käytettävyysalue on SQL_SCOPE_CURROW.

szTableQualifier- ja szTableName-argumenteissa ei voi käyttää yleismerkkejä.


SQLStatistics

Sarake:	Kommentit:
TABLE_QUALIFIER	Microsoft Access -tietolähdettä käytettäessä palautetaan tietokantatiedoston polku; dBASE-, Microsoft Excel- tai Teksti-tietolähdettä käytettäessä palautetaan kansion polku. szTableQualifier-argumentissa ei voi käyttää yleismerkkejä.
TABLE_OWNER	Tähän sarakkeeseen palautetaan arvo NULL, koska omistajan nimeä ei tueta.
TABLE_NAME	Taulukkonimi ilman erottimia. szTableName-argumentissa ei voi käyttää yleismerkkejä.
INDEX_QUALIFIER	Sarakkeeseen palautetaan aina NULL-arvo.
INDEX_NAME	Indeksistä riippuvainen.
TYPE	Sarakkeeseen palautetaan joko SQL_TABLE_STAT tai SQL_INDEX_OTHER.
SEQ_IN_INDEX	Indeksistä riippuvainen.
COLUMN_NAME	Indeksistä riippuvainen.
COLLATION	Indeksistä riippuvainen.
CARDINALITY	Palautetaan vain käytettäessä Microsoft Accessia.
PAGES	Sarakkeeseen palautetaan aina NULL-arvo.
Suodattaminen perustuu yksilöllisyyteen (fUnique-argumenttiin). fAccuracy-argumenttia ei oteta huomioon.


SQLTables

Määrite:	Kommentit:
szTableOwner	szTableOwner-argumentin ainoa kelvollinen arvo on NULL, koska yksikään ohjain ei tue omistajan nimiä. Kun szTableOwner-arvoksi asetetaan NULL, kaikki taulukot palautetaan. TABLE_OWNER-sarakkeeseen palautetaan NULL-arvo.
SzTableQualifier	Kun käytät Microsoft Excel 3.0/4.0 -ohjainta ja kutsut SQLTables-funktiota szTableQualifier-arvolla, joka ei ole jo luodun taulukon nimi, ohjain luo määritetyn nimisen taulukon. SQLTables palauttaa TABLE_QUALIFIER-sarakkeeseen joko tietokantatiedoston polun (käytettäessä Microsoft Access- tai Microsoft Excel 5.0-, 7.0- tai 97-tietolähteitä) tai kansion polun (käytettäessä dBASE-, Microsoft Excel 3.0- tai 4.0-, Paradox- ja Teksti-tietolähteitä).
SzTableType	Käytettäessä Microsoft Access -ohjainta "SYSTEM TABLE" palauttaa järjestelmätaulukon nimen, "SYNONYM" ulkoisten taulukoiden ja "VIEW" kyselyiden nimet. dBASE-, Microsoft Excel 3.0/4.0-, Paradox- tai Teksti-tietolähteiden yhteydessä tuetaan vain "TABLE"-taulukkolajia. Käytettäessä Microsoft Excel 5.0/7.0/97 -tietolähteitä "SYSTEM TABLE" palauttaa taulukoiden nimet (joiden jäljessä on $-merkki) ja "TABLE" palauttaa laskentataulukoiden sisältämät taulukot. Teksti-ohjainta käytettäessä SQLTables-funktion palauttamien taulukoiden luettelo määräytyy ODBC Tekstin asennus -valintaikkunan Tunnisteluettelo-ruudun tunnisteiden pohjalta.


SQLTransact

Microsoft Access -ohjainta käytettäessä fType-argumentin arvoja SQL_COMMIT- ja SQL_ROLLBACK tuetaan kutsuttaessa SQLTransact-funktiota.

Käytettäessä dBASE-, Microsoft Excel-, Paradox- tai Teksti-ohjainta argumentin arvo voi olla SQL_COMMIT, mutta ei SQL_ROLLBACK.

Kun Microsoft Access -ohjainta käytettäessä tapahtuu virhe päivityksen vahvistamisen aikana, vioittunut tietokanta voidaan korjata käyttämällä Microsoft Access -ohjaimen asennusohjelman Korjaa tietokanta -toimintoa tai käyttämällä REPAIR_DB-avainsanaa SQLConfigDataSource-funktiossa.


Laskuvirheet

ODBC-ohjain suorittaa SELECT-lauseen WHERE-osan kullekin taulukon riville. Jos jollain rivillä oleva arvo aiheuttaa laskuvirheen, esimerkiksi nollalla jaon tai ylivuodon, ohjain palauttaa kaikki rivit, mutta palauttaa virhetiedot laskuvirheitä aiheuttaneille sarakkeille. Tietoja lisättäessä tai niitä päivitettäessä ODBC-ohjain lopettaa kuitenkin tietojen lisäämisen tai päivittämisen heti ensimmäisen laskuvirheen sattuessa.


Ohjainten perusosoite

Kaikki ODBC Desktop Database -ohjaimet on liitetty perusosoitteeseen 0x04c0000.


Taulukoiden luominen ja avaaminen

Teksti-ohjain luo uuden taulukon käyttäen Odbcinst.ini-tiedostossa määritettyä rakennetta. Jos taulukoiden rakennetta ei ole määritetty, ne luodaan CSVDELIMITED-muodossa. Oletusarvon mukaan INTEGER-sarakkeiden oletuspituus on 11 merkkiä ja FLOAT-sarakkeiden 22 merkkiä. DATE-sarakkeissa käytetään VVVV-KK-PP-muotoa. CHAR- ja LONGCHAR-sarakkeiden leveys määritetään CREATE-lauseessa.


Useiden hstmts-kahvojen käyttäminen

Jos haluat käyttää useampaa kuin yhtä hstmt-kahvaa suorittaessasi taulukkokyselyjä ODBC Paradox -ohjaimella, taulukolla on oltava yksilöllinen indeksi (Paradox-perusavain).


Vain luku -tila

Käytettäessä Microsoft Excel- tai Teksti-ohjainta tietolähdetaulukot ovat vain luku -taulukkoja. Tästä huolimatta sovellukset voivat lisätä tietoja Microsoft Excel- ja Teksti-taulukoihin sekä päivittää Microsoft Excel -taulukoita.

Kun sovellus suorittaa Tallenna nimellä -komentoa Microsoft Excel -tiedoille Microsoft Excel -ohjaimen välityksellä, sovelluksen tulisi luoda uusi taulukko ja lisätä tallennettavat tiedot siihen. Uudet tiedot lisätään taulukon loppuun. Taulukolle ei voi suorittaa muita toimintoja, ennen kuin se on suljettu ja avattu uudelleen. Kun taulukko on suljettu, siihen ei voi sen jälkeen lisätä tietoja, koska taulukko on tuolloin vain luku -muodossa.

Käytettäessä Microsoft Excel -ohjainta arvoja voidaan päivittää, mutta Microsoft Excel -laskentataulukkoon pohjautuvasta taulukosta ei voi poistaa rivejä, joten Microsoft Excel -ohjain ei virallisesti tue päivityksiä.


Asennus-DLL

ODBC Ohjaintenhallinta kutsuu ConfigDSN-funktiota käyttäjien määrittäessä tietolähteiden asetuksia.


Käännös-DLL:t

Näitä ei tueta.


Kuvaajat

Kuvaaja on tietorakenne, jossa on tietoja joko sarakkeiden tiedoista tai dynaamisista parametreista. SQLGetDescField-funktiota voidaan käyttää hakemaan jäljempänä lueteltuja tuettuja kuvaajia. Implementation Parameter Descriptors -kuvaajien (IPD) tietoja ei haeta, koska SQLDescribeParam ei ole tuettu. Myöskään kuvaajakentät, jotka eivät ole Microsoft Jetin käytettävissä (esimerkiksi SQL_DESC_BASE_TABLE_NAME) eivät ole tuettuja.

Lisätietoja Microsoft Jetin tukemista kuvaajakentistä on julkaisussa Microsoft Jet Database Engine Programmer's Guide.

Lisätietoja kuvaajista on julkaisun ODBC Programmer's Reference luvussa "Descriptors".

Kuvaajakentät:	Tukitaso:
SQL_DESC_ALLOC_TYPE	Tuettu
SQL_DESC_ARRAY_SIZE	Tuettu vain ARD:n osalta
SQL_DESC_ARRAY_STATUS_PTR	Tuettu
SQL_DESC_BIND_OFFSET_PTR	Tuettu
SQL_DESC_BIND_TYPE	Tuettu
SQL_DESC_COUNT	Tuettu
SQL_DESC_ROWS_PROCESSED_PTR	Tuettu vain ARD:n osalta
SQL_DESC_AUTO_UNIQUE_ARVO	Tuettu
SQL_DESC_BASE_COLUMN_NAME	Tuettu (UUSI)
SQL_DESC_BASE_TABLE_NAME	Ei tuettu (Katso tämänhetkinen tila julkaisutiedoista.)
SQL_DESC_CASE_SENSITIVE	Aina FALSE
SQL_DESC_CATALOG_NAME	Ei tuettu (Katso tämänhetkinen tila julkaisutiedoista)
SQL_DESC_CONCISE_TYPE	Tuettu
SQL_DESC_DATA_PTR	Tuettu
SQL_DESC_DATETIME_INTERVAL_CODE	Tuettu
SQL_DESC_DATETIME_INTERVAL_PRECISION	Tuettu INTERVAL C -tyyppien osalta
SQL_DESC_DISPLAY_SIZE	Tuettu
SQL_DESC_FIXED_PREC_SCALE	Tuettu (TRUE valuuttamuotoisen tiedon osalta)
SQL_DESC_INDICATOR_PTR	Tuettu
SQL_DESC_LABEL	Tuettu
SQL_DESC_LENGTH	Tuettu
SQL_DESC_LITERAL_PREFIX	Tuettu
SQL_DESC_LITERAL_SUFFIX	Tuettu
SQL_DESC_LOCAL_TYPE_NAME	Ei tuettu (palauttaa tyhjän merkkijonon)
SQL_DESC_NAME	Tuettu
SQL_DESC_NULLABLE	Tuettu Huomautus   Ei tuettu ennen versiota Jet 4.0
SQL_DESC_NUM_PREC_RADIX	Tuettu
SQL_DESC_OCTET_LENGTH	Tuettu
SQL_DESC_OCTET_LENGTH_PTR	Tuettu
SQL_DESC_PARAMETER_TYPE	Vain syöteparametrien osalta
SQL_DESC_PRECISION	Tuettu
SQL_DESC_SCALE	Tuettu
SQL_DESC_SCHEMA_NAME	Ei tuettu
SQL_DESC_SEARCHABLE	Tuettu
SQL_DESC_TABLE_NAME	Ei tuettu
SQL_DESC_TYPE	Tuettu
SQL_DESC_TYPE_NAME	Tuettu
SQL_DESC_UNNAMED	Tuettu
SQL_DESC_UNSIGNED	Tuettu
SQL_DESC_UPDATABLE	Tuettu


Yhteensopivuus

Unicode on merkkien koodausmenetelmä, joka käsittelee kaikkia merkkejä kahden tavun pituisina. Tätä menetelmää käytetään vaihtoehtona Windows ANSI -merkkikoodaukselle, jossa voidaan käyttää enintään 256 merkkiä, koska se esittää merkit yhdellä tavulla. Koska Unicode voi esittää yli 65.000 merkkiä, se voi tukea monia kieliä, joiden merkkejä ei ole voitu sisällyttää ANSI-merkistöön.

ODBC 3.5 -ohjaintenhallinta (tai uudempi versio) tukee Unicodea. Tämä vaikuttaa kahteen alueeseen; funktiokutsujen ja merkkijonotyyppien käsittelyyn. Ohjaintenhallinta määrittää funktiomerkkijonoargumentit ja merkkijonotiedot sovelluksen ja ohjaimen vaatimalla tavalla; molemmat voivat tukea Unocodea tai ANSIa.

ODBC 3.5 -Ohjaintenhallinta (tai uudempi versio) tukee Unicode-ohjaimen käyttöä sekä Unicode-sovelluksessa että ANSI-sovelluksessa. Lisäksi se tukee ANSI-ohjaimen käyttöä ANSI-sovelluksessa. Ohjaintenhallinta mahdollistaa rajoitetun Unicode-ANSI-vastaavuuden Unicode-sovelluksessa, joka käyttää ANSI-ohjainta. Tämä antaa mahdollisuuden käyttää Jet 3.5 -tietokantoja ja takaa kaikkien olemassa olevien ISAM-tiedostotyyppien tuen.

Kun ANSI-sovellus käyttää ODBC Desktop Database 4.0 -ohjainta ja  Microsoft Access version 4.0 tai uudemman tietolähdettä, ohjain esittää laajennettua merkkijonotyyppiä käyttävän tiedon SQL_CHAR, SQL_VARCHAR tai SQL_LONGVARCHAR-tietotyypin mukaisena, vaikka Jet 4.0 tukee laajennettua merkkijonotyyppiä. Vanhemmat Jet-versiot eivät tue  SQL_WCHAR-, SQL_WVARCHAR- ja SQL_WLONGVARCHAR-tietotyyppejä. Tämä rajoitus koskee myös tapauksia, joissa vanhoja muotoja käytetään Jet 4.0 -tietokantamoduulin kanssa.

Lisätietoja Unicoden käytöstä ODBC:n kanssa on julkaisun ODBC Programmer's Reference luvussa "Programming Considerations".


Suorituskyvyn tehostaminen

Yhteensopivuuden varmistamiseksi aiemmin luotujen ANSI-sovellusten kanssa SQL_WCHAR-, SQL_WVARCHAR- ja SQL_WLONGVARCHAR-tietotyypit esitetään  SQL_CHAR, SQL_VARCHAR ja SQL_LONGVARCHAR-tietotyyppeinä Microsoft Access 4.0 - tietolähteissä ja uudemmissa. Tietolähteet eivät palauta  WIDE CHAR -tietotyyppejä, mutta tiedot on silti lähetettävä Jetiin Wide Char -muodossa. On tärkeää tietää, että tietojen välittäminen vaatii muunnoksen, ja ymmärtää muuntamisen vaikutus suorituskykyyn, jos SQL_C_CHAR-parametri tai tulossarake on sidottu  SQL_CHAR -tietotyyppiin ANSI-sovelluksessa.

Muuntaminen voi olla erityisen tehotonta muistin käytön suhteen, kun SQL_C_CHAR-tyyppi on sidottu LONGVARCHAR-tyypin parametriin. Koska Jet 4.0 -tietokantamoduuli ei voi käsitellä LONGTEXT-parametritietoja virtana, muuntamista varten on varattava UNICODE-puskuri, joka on kaksi kertaa suurempi kuin SQL_C_CHAR ANSI-puskuri. Sovelluksen kannalta tehokkain keino on suorittaa UNICODE-muunnos ja sitoa parametri SQL_C_WCHAR-tyyppisenä. Kun parametri on merkitty suorituksenaikaiseksi tiedoksi ja tietoja välitetään useiden SQLPutData-kutsujen avulla, tekstipuskurin koko kasvaa. Eräs tapa välttää tämän "Put Data" -puskurin kasvamisen aiheuttama suorituskyvyn heikkeneminen on välittää valinnainen pituus SQL_DATA_AT_EXEC_LEN(x)-makron avulla, käyttäen x:n arvona arvioitua kokonaistavumäärää. Tämä alustaa sisäisen PutData-puskurin kooksi x tavua.

Huomautus   Tehokas tapa lisätä tai päivittää suuria tietomääriä voi olla käyttää SQLBulkOperations()- tai SQLSetPos()-funktiota ja määrittää välitettävä tieto suorituksen aikana käsiteltäväksi SQL_DATA_AT_EXEC-parametrin avulla (kokoa ei tässä tapauksessa määritetä). Tieto voidaan välittää virtana useissa osissa kutsumalla SQLPutData-funktiota toistuvasti ja liittää näin tehokkaasti taulukkoon.


Merkkijonoparametreja hyväksyvät funktiot

Kaikki funktiot, jotka hyväksyvät merkkijonoparametreja muunnetaan Unicode-muotoon. (Funktion "W"-muoto viedään.) Tavumäärä muunnetaan merkkimääriksi soveltuvien ODBC API-funktioiden osalta. Tämä koskee seuraavia funktioita:

•	SQLConnect

•	SQLDriverConnect

•	SQLColAttributes

•	SQLDescribeCol

•	SQLError (korvataan SQLGetDiagField-funktiolla)

•	SQLExecDirect

•	SQLGetCursorName

•	SQLSetCursorName

•	SQLGetStmtAttr

•	SQLGetInfo

•	SQLGetStmtOption (uusi funktio SQLGetStmtAttr)

•	SQLSetStmtOption (uusi funktio SQLSetStmtAttr)

•	SQLGetConnectOption

•	SQLSetConnectOption

•	SQLGetTypeInfo

•	SQLStatistics

•	SQLTables

•	SQLNativeSQL

•	SQLSpecialColumns

•	ConfigDSNEx

•	ConfigDSN


Diagnostiikka

Ohjain käsittelee kaikki virheet ja varoitukset, joita Ohjaintenhallinta ei tarkista tai jotka se tarkistaa vain osittain. Ohjain näyttää myös alkuperäisvirheitä tai tietolähteen palauttamia virheitä vastaavat SQLSTATE-sanomat. Kaikkiin julkaisussa ODBC Programmer's Reference lueteltuihin funktioihin liittyy diagnostiikka-osa, jossa määritetään ehdot ja sanomat.

Sovellukset kutsuvat SQLGetDiagRec-funktiota SQLSTATE-sanoman, alkuperäisten virhekoodien ja diagnostiikkasanomien palauttamiseen. SQLGetDiagField.funktion kutsuminen kenttä-parametrin avulla palauttaa yksittäisiä diagnostiikkakenttiä. Diagnostiikkatunnusten tuki ilmenee alla olevasta taulukosta.

Tunnus:	Tuki:
SQL_DIA_DYNAMIC_FUNCTION	Ei tuettu
SQL_DIAG_CLASS_ORIGIN	Tuettu. Palautettu arvo on aina "ODBC 3.0" tämän ohjaimen version 3.0 ja uudempien osalta.
SQL_DIAG_COLUMN_NUMBER	Tuettu
SQL_DIAG_CURSOR_ROW_COUNT	Ei tuettu
SQL_DIAG_DYNAMIC_FUNCTION_CODE	Ei tuettu
SQL_DIAG_MESSAGE_TEXT	Tuettu
SQL_DIAG_NATIVE	Tuettu
SQL_DIAG_NUMBER	Tuettu
SQL_DIAG_RETURNCODE	Tuettu mutta Ohjaintenhallinnan välityksellä
SQL_DIAG_ROW_COUNT	Tuettu
SQL_DIAG_ROW_NUMBER	Tuettu
SQL_DIAG_SERVER_NAME	Ei tuettu
SQL_DIAG_SQLSTATE	Tuettu
SQL_DIAG_SUBCLASS_ORIGIN	Tuettu


Johdanto

Katso myös

ODBC Desktop Database 4.0 -ohjainten ja (ODBC)-liittymän (Open Database Connectivity) avulla voit avata tietokantoja ja tehdä niiden pohjalta kyselyjä. Nämä ohjaimet toimivat ODBC:n versiossa 3.51 tai sitä uudemmissa versioissa.


ODBC Desktop Database -ohjaimien uudet ominaisuudet

Unicode-tuki

Jet Database -tietokantamoduulin esitysmuoto on version 4.0 myötä muuttunut ANSIsta Unicodeksi. Microsoft Access 4.0 -ohjain näyttää alkuperäiset Unicode-tiedot niin, että  Unicode-sovellukset voivat käyttää Unicode-tietoja suoraan, ja se antaa lisäksi mahdollisuuden tietojen muuntamiseen Unicodesta ANSIin ANSI-sovelluksia varten.

Lisätietoja Unicodesta onjulkaisun  ODBC Programmer's Reference luvussa 17 “Programming Considerations” Unicodea käsittelevässä osassa ja tämän oppaan "Yhteensopivuus"-aiheessa.

Kuvaajatuki

Kuvaajissa on otsikko- ja tietuekenttiä, joissa sarakkeet ja parametrit kuvataan täydellisesti. Vaikka mitkään tietokantatoiminnot eivät edellytäkään, että sovellus käyttää kuvaajia suoraan, kuvaajien käyttäminen voi helpottaa monia toimintoja. SQLGetDescField-funktio on nyt tuettu. SQLDescribeParam-funktio ei ole tuettu. Siten myöskään Implementation Parameter Descriptor (IPD) -kuvaajan tietojen automaattinen palauttaminen ei ole tuettua.

Lisätietoja kuvaajista on julkaisun ODBC Programmer's Reference luvussa 13 "Descriptors".

SQLGetDiagField- ja SQLGetDiagRec-tuki

Jetiin on lisätty rajoitettu SQLGetDiagField- ja SQLGetDiagRec-funktioiden tuki.

SQLBulkOperations

Tuen lisäämisen ansiosta Jet-tietokantamoduulin avulla voi nyt palauttaa kirjanmerkin juuri lisätylle riville.

Locale-ilmaisimet

Jet-tietokantamoduulin yhteysmerkkijonoa on muutettu niin, että paikallistiedot ilmaistaan yksittäisellä LCID-tunnuksella erillisten CodePage- ja LangID-tunnusten asemesta. Tämä lisäys näkyy ODBC Microsoft Access Asennus -valintaikkunassa. Ohjelmointia koskevat muutokset on mainittu Ohjeen aiheissa Tietokannan uudelleenjärjestäminen (laajennettu kielioppi), Tietokannan korjaaminen (laajennettu kielioppi) ja Tietokannan luominen (laajennettu kielioppi).

Tietotyypit

Jet-tietokantamoduuli tukee seuraavia uusia C-tietotyyppejä ja SQL-tietotyyppejä.

Uudet tuetut tietotyypit:

Tietotyyppi:	Nimi:	Huomautukset:
C-tietotyyppi	SQL_C_WCHAR
C-tietotyyppi	SQL_C_NUMERIC
C-tietotyyppi	SQL_C_GUID
C-tietotyyppi	SQL_C_SBIGINT
C-tietotyyppi	SQL_C_UBIGINT
C-tietotyyppi	SQL_C_INTERVAL_*	Kaikki
C-tietotyyppi	SQL_WCHAR	Näkyy vain  Unicode-sovelluksissa, jotka käyttävät Microsoft Access 4.0 -versiota tai uudempaa.
SQL-tietotyyppi	SQL_WVARCHAR	Näkyy vain  Unicode-sovelluksissa, jotka käyttävät Microsoft Access 4.0:aa tai uudempaa.
SQL-tietotyyppi	SQL_WLONGVARCHAR	Paljastuu vain  Unicode-sovelluksissa, jotka käyttävät Microsoft Access 4.0:aa tai uudempaa Enimmäispituus on lyhennetty puoleen ja on nyt 1073741824.
SQL-tietotyyppi	SQL_NUMERIC	Enimmäistarkkuus 28
SQL-tietotyyppi	SQL_GUID
Huomautus  Microsoft Access 4.0 -versiossa ja uudemmissa SQL_BINARY- ja SQL_VARBINARY-tietotyyppien enimmäispituus on kaksinkertaistettu arvoon 510 (aiempi arvo oli 255).

Lisätietoja tietotyypeistä on julkaisun ODBC Programmer's Reference -liitteessä D "Data Types".

ODBC 3.x -ominaisuudet, joita ei tueta:

•	Implementation Parameter Descriptor -kuvaajan tietojen automaattinen palauttaminen

•	Parametritaulukot

•	SQLMoreResults-funktio ja eräsuorittamiseen liittyvät lisäykset

•	Kuvaajakentät, jotka eivät ole käytettävissä Jetissä (esimerkiksi BASE_TABLE_NAME)

DATETIME-toiminnot

QUARTER, DAYNAME  ja MONTHNAME on lisätty SQLGetInfo -funktion InfoType-argumentin SQL_SQL92_DATETIME_FUNCTIONS -tukemiin arvoihin.

Ympäristökentät

ODBC Desktop Database Drivers -ohjaimet tukevat seuraavia ODBC 3.x ja ODBC 2.x -toimintoja avainjoukkoperusteisia (keyset driven) lukutyyppisiä kohdistimia käytettäessä: vaihtelevan pituiset kirjanmerkit, X/OPEN SQLSTATE-vakioarvot, SQLSetEnvAttr-funktio, SQL_NO_DATA-arvon palauttaminen turhissa päivityksissä ja monirivinen tietojen noutaminen SQLFetch-funktion avulla.

Muuttunut Visual FoxPro -ohjaintuki

ODBC Desktop Database Drivers -pakkaukseen ei kuulu IISAM-tiedostoa (Msxbse40.dll) Visual FoxProta varten. Suositeltava ohjain on "Visual FoxPro ODBC Driver", jonka voi ladata Microsoft Support Online -sivuston Development Toos -saston Visual FoxPro -sivulta. Ohjaimen mukana toimitetaan erillinen käyttöopas.


Desktop Database Drivers -arkkitehtuuri

Ohjainten käyttöympäristöksi on tarkoitettu Microsoft Windows 95- tai uudempi järjestelmäversio taikka Windows NT 4.0 tai uudempi järjestelmäversio. Vain 32-bittisiä sovelluksia tuetaan Windows 95 tai uudemmassa käyttöjärjestelmässä; Windows NT 4.0 tai uudemmassa käyttöjärjestelmässä tuetaan sekä 16-bittisiä että 32-bittisiä sovelluksia .

Huomautus   Tietoja näiden ohjainten kanssa käytettävästä ODBC-versiosta on julkaisussa ODBC Programmer's Reference sekä vanhoissa ja uusissa versiohuomautuksissa. Jollei toisin mainita, nämä ohjaimet ovat julkaisun ODBC Programmer's Reference määritysten mukaisia.

ODBC Desktop Database Drivers -ohjaimin kuuluu 32-bittisiä ohjaimia Microsoft Access, dBASE, Microsoft Excel, Paradox ja Teksti-tietolähteitä varten. Niihin ei kuulu 16-bittisiä ohjaimia. (Microsoft FoxPro -ohjain on saatavissa erikseen.)

Windows 95:n tai uudemman version sovellus- ja ohjainarkkitehtuuri on esitetty seuraavanlainen:

Sovellus (32 bittinen)
|
ODBC-Ohjaintenhallinta
(ODBC32.dll)
|
ODBC Desktop Database -ohjain
(Odbcj32.dll, Msjet35.dll, 32-bittisen ohjaimen-ISAM-menetelmät)
|
tietokanta

Näiden ohjaimien käyttämistä ei tueta 16-bittisissä sovelluksissa Windows 95:ssä.

Windows NT version 4.0 tai uudemman version sovellus- ja ohjainarkkitehtuuri on esitetty seuraavassa:

Sovellus (16-bittinen)	     Sovellus (32-bittinen)

|	|
ODBC-Ohjaintenhallinta
(Odbc.dll)
|	|
16-Bit ODBC Generic Thunking DLL
(Odbc16gt.dll)
|	|
32-Bit ODBC Generic Thunking DLL
(Odbc32gt.dll)
|	|
ODBC-OhjaintenhallintaODBC-Ohjaintenhallinta
(Odbc32.dll)	(Odbc32.dll)
|	|
ODBC Desktop Database -ohjain
(Odbcjt32.dll, Msjet35.dll, 32-bittisen ohjaimen-ISAM-menetelmät)

|
tietokanta


Ohjaimen ISAM tiedostot

Katso myös

Seuraavassa on lueteltu ODBC Desktop Database 4.0 -ohjaimen ISAM-tiedostot:

Ohjain:	32 bittinen ISAM:	Versio:t
Microsoft Access	Ei erillistä tiedostoa (sisältyy Msjet40.dll tiedostoon)	Microsoft Access -versiot 7.0 ja 97
Microsoft Access	Msrd2x40.dll	Microsoft Access -versio 2.0
Microsoft Access	Msrd3x40.dll	Microsoft Access -versio 3.0
dBase	Msxbde40.dll	dBASE-versiot III, IV ja V (dBASE for Windows)
Microsoft Excel	Msexcl40.dll	Microsoft Excel -versiot 3.0, 4.0, 5.0, 7.0, 97 (1)
Paradox	Mspbde40.dll	Paradox -versiot 3.5, 4.0, 4.5, 5.x (Paradox for Windows)
Teksti	Mstext40.dll	ASCII-teksti

1	Microsoft Excel -ohjain ei pysty lukemaan Microsoft Excel -tiedostoja, jotka on luotu versiota 3.0 aiemmalla versiolla. Nämä tiedostot voi avata Microsoft Excelin uudemmalla versiolla ja tallentaa muodossa 3.0, 4.0, 5.0, 7.0 tai 97, jolloin ohjain pystyy lukemaan ne.

Microsoft FoxPro

ODBC Desktop Database -ohjaimiin ei kuulu Microsoft FoxPro-ohjainta. Microsoft FoxPro -ohjaimen voi ladata Microsoft Support Online -sivustosta.

Rekisteriasetukset

IISAM-rekisteriasetukset luodaan alunperin kutsuttaessa DLLRegisterServer-funktiota kullekin IISAM DLL-tiedostolle, ja ne poistetaan, kutsuttaessa DLLUnregisterServer-funktiota. DLLRegisterServer-funktiota kutsutaan Jet ODBC-funktiolla dynaamisesti kunkin IISAM DLL-tiedoston osalta. Jos esimerkiksi ytitetään muodostaa yhteys käyttämällä Paradox IISAM -tiedostoa, ja se ensin epäonnistuu, ohjain yrittää alustaa tämän IISAM-tiedoston (kutsumalla DLLRegisterServer-funktiota) ja yrittää yhteyden muodostamista uudestaan.


ODBC-osatiedostot

Katso myös

Seuraavassa taulukossa luetellaan tiedostot, joita ODBC Desktop Database 4.0 -ohjainten kukin osa tarvitsee. Nämä tiedostot on asennettu Windowsin System-kansioon käytettäessä Windows 95:tä tai uudempaa versiota ja \Windows\System32-kansioon käytettäessä Windows NT 3.51:tä tai uudempaa versiota. Jos ODBC-tiedostot olivat aiemmin asennettuina johonkin toiseen kansioon, varmista, että käytät Windowsin System- (tai System32-) kansion sisältämiä uudempia tiedostoja.

Jotkin tiedostot ovat useampien kuin yhden osan tarvitsemia. Jos toimitat sovelluksesi mukana jonkin ODBC-tietokantaohjaimen, myös sitä vastaavat osatiedostot on toimitettava.

Seuraavia tiedostoja tarvitaan kaikissa ODBC Desktop Database 4.0 -ohjaimissa:

Ds16gt.dll Ds32gt.dll Expsrv.dll Msjint40.dll Msjet40.dll Msjter40.dll Msjtes40.dll Msvcrt40.dll Odbc16gt.dll	Odbc32.dll Odbc32gt.dll Odbccp32.cpl Odbccp32.dll  Odbccr32.dll Odbcinst.cnt Odbcinst.hlp Odbcint.dll  Odbcjet.hlp	Odbcjet.cnt  Odbcji32.dll Odbcjt32.dll Odbcjtnw.hlp Odbcjtnw.cnt Odbctl32.dll  Vbajet32.dll Odbctrac.dll
Seuraavat tiedostot ovat ohjainkohtaisia:

Ohjain:	Tiedosto:
Microsoft Access	Msrd2x40.dll Msrd3x40.dll
dBASE	Msxbse40.dll Oddbse32.dll
Microsoft Excel	Msexcl40.dll Odexl32.dll
Paradox	Mspdox40.dll Odpdx32.dll
Teksti	Mstext40.dll Odtext32.dll


Laitteisto- ja ohjelmistovaatimukset

Laitteistovaatimukset

ODBC-tietokantaohjainten käyttäminen edellyttää seuraavia laitteita:

•	IBM-yhteensopiva henkilökohtainen tietokone

•	kiintolevy, jolla on 6 megatavua vapaata levytilaa

•	vähintään 16 megatavua RAM-muistia.

Ohjelmistovaatimukset

Tietojen käsitteleminen ODBC-ohjaimella edellyttää seuraavia ohjelmia:

•	ODBC-ohjain

•	32-bittinen ODBC Ohjaintenhallinta 3.51 tai uudempi versio (Odbc32.dll)

•	Microsoft Windows 95 tai uudempi versio tai Windows NT 3.51 tai uudempi versio

•	Microsoft ODBC -ohjainta käyttävässä sovelluksessa vähintään 20 kilotavun pinokoko.

Kun käytetään Microsoft Windows NT 4.0:aa tai uudempaa, 32-bittinen ohjain on säievarma, mutta vain käytettäessä yleistä semaforia, joka valvoo ohjaimen käyttöä. Ohjaimen samanaikainen käyttö on hyvin rajoitettua Windows NT:ssä. Kaikki Microsoft Jet -moduulia käyttävät sovellukset voivat käyttää Jet ISAM -kerrosta vain yksisäietilassa.

Käytettäessä samanaikaisesti useita 16-bittisiä sovelluksia Windows on Windows (WOW) -tilassa Microsoft Windows NT 4.0:ssa suoritettavien sovellusten on oltava eri muistialueissa. (Samaa muistialuetta ei voi käyttää, koska ODBC ei tue useaa ympäristöä samassa prosessissa.) Jos haluat suorittaa sovelluksen erillisessä muistitilassa, valitse sovelluksen kuvake Microsoft Windows NT:n Resurssienhallinnassa, valitse Tiedosto-valikosta Ominaisuudet ja valitse sen jälkeen vaihtoehto Suorita erillisellä muistialueella -valintaruutu.

Windows 95 -järjestelmässä 16-bittiset sovellukset eivät voi käyttää näitä ohjaimia.

Ohjainkohtaiset laitteisto- ja ohjelmistovaatimukset

•	Microsoft Access- ja dBASE-ohjainten käyttäminen voi edellyttää muutoksien tekemistä Autoexec.bat tai Config.sys -tiedostoon.


Config.sys ja Autoexec.bat tiedostojen muutokset

Jos käytät Microsoft Access ODBC -ohjainta Microsoft Windows 95/98 -järjestelmässä (et Microsoft Windows NT -järjestelmässä) eikä koneeseesi ole asennettu Microsoft Accessia, lisää rivi "FILES= 50" Config.sys-tiedostoon.


Ohjainten asentaminen

1	Kaksoisnapsauta ensin Ohjauspaneeli-kuvaketta ja sitten Ohjauspaneeli-ikkunan ODBC-tietolähdekuvaketta (tai avaa ODBC Hallinta suoraan).

2	Valitse ODBC Hallinnan-Ohjaimet-välilehti.

Ohjaimia ei voi enää lisätä Ohjauspaneeliin tai ODBC Hallintaan tai poistaa niistä, koska Lisää- ja Poista-painikkeet on poistettu ODBC Hallinnan-Ohjaimet-välilehdestä. Ohjaimia voidaan lisätä ja poistaa vain ODBC-tietokantaohjainten asennuksen yhteydessä.


Tietolähteen lisääminen

Katso myös

1	Kaksoisnapsauta ensin Ohjauspaneeli-kuvaketta ja sitten Ohjauspaneeli-ikkunan ODBC-tietolähteet-kuvaketta.

2	Valitse Käyttäjätietolähde-, Järjestelmätietolähde- tai Tiedostotietolähde-välilehti.

3	Valitse Uusi-painike.

4	Valitse ohjaimen nimi Luo uusi tietolähde -valintaikkunassa ja noudata ohjatun toiminnon ohjeita.


Tietolähteen muokkaaminen

1	Kaksoisnapsauta ensin Ohjauspaneeli-kuvaketta ja sitten Ohjauspaneeli-ikkunan ODBC-tietolähteet-kuvaketta.

2	Valitse Käyttäjätietolähde-, Järjestelmätietolähde- tai Tiedostotietolähde-välilehti muokattavan tietolähteen lajin mukaan.

3	Valitse tietolähde luettelosta. Jos muokkaat tiedostotietolähdettä, etsi haluamasi kansio Kohde-ruudusta (napsauta ylänuolta, jos tarpeen) ja valitse sitten tietolähde kansiosta.

4	Valitse Määritä-painike ja määritä sitten tietolähteen asetukset tarpeen mukaan.


Tietolähteen poistaminen

1	Kaksoisnapsauta ensin Ohjauspaneeli-kuvaketta ja sitten Ohjauspaneeli-ikkunan ODBC-tietolähteet-kuvaketta.

2	Valitse Käyttäjätietolähde-, Järjestelmätietolähde- tai Tiedostotietolähde-välilehti muokattavan tietolähteen lajin mukaan.

3	Valitse tietolähde luettelosta. Jos muokkaat tiedostotietolähdettä, etsi sen kansio Kohde-ruudusta (napsauta ylänuolta, jos tarpeen) ja valitse sitten tietolähde kansiosta.

4	Valitse Poista-painike ja vahvista sitten poisto valitsemalla Kyllä-painike.


Tietolähteen muuntaminen

ODBC Desktop Database -ohjainten version 2.0 kanssa käytetyt 32-bittiset tietolähteet muunnetaan automaattisesti uusiksi 32-bittisiksi tietolähteiksi ohjainversiota 4.0 varten. 16-bittisiä tietolähteitä ei muunneta. Kun haluat muuntaa 16-bittisen tietolähteen 32-bittiseksi, luo uusi 32-bittinen tietolähde ja poista (halutessasi) vanha 16-bittinen tietolähde. 32-bittinen ja 16-bittinen tietolähde eivät saa olla samannimisiä.


Tietolähteen lisääminen, muuttaminen tai poistaminen suorituksen aikana

Katso myös

SQLConfigDataSource-funktion avulla voit lisätä tai poistaa tietolähteen sekä muokata tietolähteen asetuksia suorituksen aikana. Tämä funktio määrittää avainsanojen avulla Ohjauspaneelin ODBC Hallinnan Asennus-valintaikkunan avulla määritettävät asetukset. Tämän funktion avulla voit lisätä tai poistaa tietolähteen tai muokata sen asetuksia käyttämättä Asennus-valintaikkunaa.


Tuotetuki

ODBC-tuotetukea saat Microsoftilta. Koska monet Microsoftin tuotteet käyttävät ODBC:tä ydinkomponenttina ja niiden mukana toimitetaan ODBC-ohjaimia, Microsoftin tuotetuki antaa ODBC-tuotetukea kaikille eri tuotteille, joissa ODBC on komponenttina. Annettava tuotetuki vaihtelee kunkin tuotteen tukisopimuksen mukaan. Kaikilla Microsoft-tuotteilla on oma tukitarjouksensa, joka on kuvattu tuotteen mukana toimitetuissa ohjeissa. Katso ohjeista, mitkä tukivaihtoehdot ovat saatavissa.


ODBC <tietolähde>-Asennus -valintaikkuna

ODBC <tietolähde> Asennus -valintaikkunassa ovat seuraavassa kuvatut ohjausobjektit. Ota huomioon, että useimmat näistä asetuksista voidaan määrittää myös suorituksen aikana kutsumalla SQLConfigDataSource-funktiota asetuksia vastaavilla avainsanoilla.

ImplicitCommitSync

Järjestelmätietokanta

Kansio

Kieli

Kuvaus

Käyttäjätunnus

Käytä nykyistä kansiota

Lajittelujärjestys

Läpikäytävät rivit

Määritä muoto

Näytä poistetut rivit

Puskurin koko

Rivimääräarvio

Salaus

Sivun aikakatkaisu

Säikeet

Tietokanta

Tietolähteen nimi

Tunnisteluettelo

UserCommitSync

Vain luku

Valitse indeksit

Valitse kansio

Valitse työkirja

Valitse verkkokansio

Verkkolaji

Versio

Yksityinen


Rivimääräarvio

(Tämä ohjausobjekti näkyy vain käytettäessä dBASE-ohjainta.)

Määrittää, arvioidaanko taulukon rivien määrä. Tämä asetus vaikuttaa kaikkiin ODBC-ohjainta käyttäviin tietolähteisiin. Voit määrittää tämän asetuksen suorituksen aikana käyttämällä STATISTICS-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Puskurin koko

(Tämä ohjausobjekti näkyy vain käytettäessä Microsoft Access -ohjainta.)

Näyttää kilotavuina sen sisäisen puskurin koon, jota Microsoft Access käyttää siirtäessään tietoja muistista levylle ja levyltä muistiin. Oletuspuskurikoko on 2048 kilotavua (näytetään muodossa 2048). Mikä tahansa 256:lla jaollinen kokonaisluku kelpaa puskurikoon arvoksi. Voit määrittää tämän asetuksen suorituksen aikana käyttämällä MAXBUFFERSIZE-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Lajittelujärjestys

(Tämä ohjausobjekti näkyy vain käytettäessä dBASE- ja Paradox-ohjaimia.)

Määrittää kenttien lajittelujärjestyksen.

Käytettäessä dBASE-ohjainta järjestys voi olla joko ASCII (oletusarvo) tai kansainvälinen.

Käytettäessä Paradox-ohjainta järjestys voi olla ASCII (oletusarvo), kansainvälinen, suomi-ruotsi tai norja-tanska.

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä COLLATINGSEQUENCE-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Tietolähteen nimi

Tietolähteen nimi, esimerkiksi Palkkalista tai Henkilökunta.

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä DSN-avainsanaa kutsuessasi  SQLConfigDataSource-funktiota.


Tietokanta

Katso myös

(Tämä ohjausobjekti näkyy vain käytettäessä Microsoft Access -ohjainta.)

Määrittää käytettävän Microsoft Access -tietokannan koko polun. Voit valita aiemmin luodun tietokannan Valitse-painikkeella tai voit luoda ja valita uuden Microsoft Access -tietokannan valitsemalla Luo-painikkeen.

Microsoft Access -tietolähde voidaan määrittää valitsematta tai luomatta tietokantaa. Jos tietokantaa ei määritetä asennuksen yhteydessä, ohjelma pyytää käyttäjää valitsemaan tietokantatiedoston tietolähdeyhteyttä luotaessa.

Voit korjata vioittuneen tietokannan valitsemalla Korjaa-painikkeen. Valitsemalla Järjestä uudelleen -painikkeen voit järjestää tietokannan uudelleen.

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä DBQ-avainsanaa kutsuessasi  SQLConfigDataSource-funktiota.


Määritä muoto

Katso myös

(Tämä ohjausobjekti näkyy vain käytettäessä Teksti-ohjainta.)

Tuo näyttöön Määritä tekstimuoto -valintaikkunan ja mahdollistaa rakenteen määrittämisen tietolähdekansion yksittäisille taulukoille.

Tätä asetusta ei voi määrittää suorituksen aikana kutsumalla SQLConfigDataSource-funktiota.


Kuvaus

Valinnainen kuvaus tietolähteen tiedoista, esimerkiksi "Kaikkien työntekijöiden työsuhteen alkamisajankohta, palkkatiedot ja työntekijöiden arviointitiedot".

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä DESCRIPTION-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Kansio

Näyttää valittuna olevan kansion sisällön. Ennen tietolähteen lisäämistä sinun on joko valittava kansio Valitse hakemisto -painikkeella tai valittava Käytä nykyistä kansiota -valintaruutu voidaksesi käyttää sovelluksen nykyistä työkansiota. (Tämä ei koske Microsoft Access -ohjainta.)

Microsoft Excel 3.0/4.0 -tiedostojen osalta painikkeen otsikko on "Valitse kansio", Microsoft Excel 5.0, 7.0 tai 97 -tiedostojen osalta "Valitse työkirja".

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä DEFAULTDIR-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Salaus

(Tämä ohjausobjekti näkyy vain käytettäessä Microsoft Access -ohjainta ja on käytettävissä vain jos valittuna on 4.x-versio.)

Microsoft Jet-tietokantamoduulin version 4.0 julkaisun myötä tietokannan tiedot voidaan tietokannan luomisen yhteydessä määrittää salattaviksi. Lisätietoja on julkaisussa Jet Engine Programmer's Reference.


Yksityinen

(Tämä ohjausobjekti näkyy vain käytettäessä dBASE-, Microsoft Access- ja Paradox-ohjaimia.)

Jos Yksityinen-ruutu on valittuna, ohjelma avaa tietokannan yksityiskäyttöön, jolloin tietokantaa voi käyttää vain yksi käyttäjä kerrallaan. Jos Yksityinen-ruudun valinta poistetaan, tietokanta avataan jaetussa tilassa, jolloin sitä voi käyttää useita käyttäjiä samanaikaisesti. Ohjaimen suorituskyky on parempi käytettäessä yksityiskäyttötilaa.

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä EXCLUSIVE-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Tunnisteluettelo

(Tämä ohjausobjekti näkyy vain käytettäessä Teksti-ohjainta.)

Luettelee tekstimuotoisten tietolähteiden tunnisteet. Kun haluat näyttää kansion kaikki tiedostot, valitse Oletusarvo (*.*) -valintaruutu. Kun haluat näyttää vain tiedostot, joilla on tietyntyyppinen tunniste, poista Oletusarvo (*.*) -valintaruudun valinta ja lisää näytettävien tiedostojen tunnisteet. Kun Oletusarvo (*.*) -ruutua ei ole valittu, tunnisteluettelon oletustunnisteiksi tulevat *.asc, *.csv, *.tab ja *.txt.

Kun haluat lisätä tunnisteen luetteloon, kirjoita se Tunniste-ruutuun ja valitse Lisää-painike. Tunnisteen muodon on oltava *.xxx. Kun haluat käyttää esimerkiksi tiedostoja, joiden tunniste on .dat, kirjoita tunniste *.dat. Kun haluat poistaa tunnisteen, valitse se Tunniste-luettelosta ja valitse Poista-painike. Kaikkien tunnisteiden poistaminen vaikuttaa samoin kuin Oletusarvo (*.*) -valintaruudun valitseminen: kaikki tiedostot tulevat näyttöön.

Teksti-ohjain luo tunnisteettoman tiedoston, kun CREATE TABLE -lause suoritetaan tunnisteetonta tiedostonimeä käyttäen. Muut ohjaimet luovat tiedoston, jolla on oletustunniste, kun tunnistetta ei anneta. Kun haluat luoda tiedoston, jonka tunniste on .txt, tunniste on kirjoitettava osana tiedoston nimeä. Kun haluat näyttää tunnisteettomat tiedostot Määritä tekstimuoto -valintaikkunassa, Tunniste-luetteloon on lisättävä merkit "*.".

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä EXTENSIONS-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


ImplicitCommitSync

(Tämä ohjausobjekti näkyy vain käytettäessä Microsoft Access -ohjainta.)

Määrittää, kuinka tapahtumasarjan ulkopuoliset muutokset kirjoitetaan tietokantaan. Oletusarvo on "Yes", mikä merkitsee, että Microsoft Access -ohjain odottaa, että sisäiset tai implisiittiset tapahtumasarjat suoritetaan loppuun.

Tämä vaihtoehto on Microsoft Access -ohjaimen Määritä lisäasetukset -valintaikkunassa.


Verkkolaji

(Tämä ohjausobjekti näkyy vain käytettäessä Paradox-ohjainta.)

Käytä seuraavia verkkolajeja käyttäessäsi Paradoxin tietoja: joko lajia "3.x" Paradox version 3.x kanssa tai "4.x" Paradox versioiden 4.x tai 5.x kanssa. Verkkolajiksi voidaan asettaa "3.x" tai "4.x", jos käytettävä Paradox versio on 4.x tai 5.x. Jos käytettävä Paradoxin versio on 3.x, verkkolajin on oltava "3.x".

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä PARADOXNETSTYLE-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Sivun aikakatkaisu

(Tämä ohjausobjekti näkyy vain käytettäessä dBASE-, Microsoft Access-, ja Paradox-ohjaimia.)

Määrittää sekunnin kymmenesosina ajan, jonka sivu (jos se ei ole käytössä) säilyy puskurissa, ennen kuin se poistetaan. Microsoft Access -ohjaimen oletusarvo on 5 sekunnin kymmenesosaa (0,5 sekuntia). dBASE- ja Paradox-ohjainten oletusarvo on 600 sekunnin kymmenesosaa (60 sekuntia). Tämä vaihtoehto vaikuttaa kaikkiin ODBC-ohjainta käyttäviin tietolähteisiin.

Sivun aikakatkaisun arvo ei voi olla 0 luontaisen viiveen takia. Sivun aikakatkaisu ei voi olla luontaista viivettä pienempi, vaikka Sivun aikakatkaisu -asetus olisi määritetty viiveen arvoa pienemmäksi.

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä PAGETIMEOUT-avainsanaa kutsuessasi SQLConfigDataSource-funktiota


Vain luku

Määrittää tietokannan vain luku -tietokannaksi.

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä READONLY-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Läpikäytävät rivit

(Tämä ohjausobjekti näkyy vain käytettäessä Microsoft Excel- ja Teksti-ohjaimia.)

Määrittää sarakkeen tietotyypin määrityksessä tarkistettavien rivien määrän. Tietotyyppi määräytyy sen mukaan, mitä tietotyyppiä riveistä löytyy eniten. Jos sarakkeessa on arvoja, jotka eivät vastaa sarakkeelle arvattua tietotyyppiä, ne saavat arvon NULL (tyhjä).

Microsoft Excel -ohjainta käytettäessä tarkistettavien rivien määräksi voi määrittää luvun  1 - 16. Oletusarvo on 8. Jos arvoksi asetetaan 0, kaikki rivit tarkistetaan. (Sallittuun alueeseen kuulumaton arvo aiheuttaa virheen.)

Teksti-ohjainta käytettäessä tarkistettavien rivien määräksi voi määrittää luvun 1 - 32767. Oletusarvo on kuitenkin aina 25. (Sallittuun alueeseen kuulumaton arvo aiheuttaa virheen.)

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä MAXSCANROWS-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Valitse kansio

(Tämä ohjausobjekti näkyy vain käytettäessä dBASE-, Microsoft Excel 3.0/4.0-, ja Teksti-ohjaimia.)

Tuo näyttöön valintaikkunan, jossa voit valita haluamasi tiedostot sisältävän kansion.

Kun käytössä on jokin muu kuin Microsoft Access -ohjain, valitse tietolähteen kansiota määrittäessäsi kansio, jonka tiedostoja käytät useimmin. ODBC-ohjain käyttää tätä oletuskansiona. Kopioi tähän kansioon kaikki usein käyttämäsi tiedostot. Voit myös määrittää tiedostonimien polun SELECT-lauseessa:

SELECT * FROM C:\OMAHAK\HENK

Jos haluat määrittää uuden oletuskansion, voit käyttää SQLSetConnectOption-funktiota ja SQL_CURRENT_QUALIFIER-vaihtoehtoa.

Käytettäessä Microsoft Access -ohjainta oletuskansion voi määrittää Määritä lisäasetukset -valintaikkunan DefaultDir-asetuksen avulla. Asetusta käytetään, kun luot tietolähteen ilman vastaavaa .mdb-tiedostoa.

Kansion tai työkirjan polut (Microsoft Excel)

Microsoft Excel 3.0/4.0 -tiedostoilla polun otsikko on "Kansio" ja vastaavan komentopainikkeen otsikko on "Valitse kansio". Microsoft Excel 5.0/7.0/97 -tiedostoilla polun otsikko on "Työkirja" ja vastaavan komentopainikkeen otsikko on "Valitse työkirja". Valitse tietolähdettä määrittäessäsi kansio, joka sisältää useimmin käyttämäsi Microsoft Excel 3.0/4.0 -tiedostot. Microsoft Excel 5.0/7.0/97 -tietolähde määritetään valitsemalla yksittäinen työkirjatiedosto. Käytä nykyistä kansiota -vaihtoehto on himmennetty, kun tietolähteeksi on valittu Microsoft Excel 5.0, 7.0 tai 97.

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä DEFAULTDIR-avainsanaa kutsuessasi SQLConfigDataSource-funktiota


Valitse indeksit

Katso myös

(Tämä ohjausobjekti näkyy vain käytettäessä dBASE-ohjainta.)

Tuo näyttöön Valitse indeksit -valintaikkunan, jossa voit määrittää dBASE-tiedostojen käsittämät indeksitiedostot. Valitse indeksit -valintaikkunassa ovat seuraavassa kuvatut ohjausobjektit.

Taulukot

Näyttää luettelon valittuna olevan tietolähteen tiedostoista.

Indeksit

Näyttää Taulukot-luettelosta valitulle tiedostolle asetetut indeksit.

Luettele tiedostot tyypeittäin

Näyttää Indeksit-luettelossa näkyvät tiedostotyypit.

Indeksin liittäminen taulukkoon

1	Valitse tiedosto Taulukot-luettelosta.

2	Valitse indeksi Indeksit-luettelosta.

3	Tallenna taulukon ja indeksin välinen liitäntä valitsemalla OK.

Huomautus   dBASE III -indeksit on määritettävä tämän valintaikkunan avulla, muutoin ohjain ei tunnista niitä.

Huomautus   ODBC dBASE -ohjaimet eivät tue Clipperin .ntx-indeksitiedostoja.

Tätä asetusta ei voi määrittää suorituksen aikana SQLConfigDataSource-funktion avulla.


Valitse verkkokansio

(Tämä ohjausobjekti näkyy vain käytettäessä Paradox-ohjainta.)

Määritä Paradox-lukitustietokannan sisältävän kansion koko polku. Kansio sisältää joko Pdoxusrs.net-tiedoston (Paradoxin versiossa 4.x) tai Paradox.net-tiedoston (Paradoxin versiossa 5.x). Jos kumpaakaan tiedostoa ei ole kansiossa, Paradox-ohjain luo jommankumman tiedoston. Lisätietoja näistä tiedostoista on Paradoxin ohjeissa.

Voit valita verkkokansion vasta, kun olet kirjoittanut Paradox-käyttäjätunnuksesi Käyttäjätunnus-tekstiruutuun. Voit valita verkkokansion Valitse verkkokansio -painikkeen avulla.

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä PARADOXNETPATH-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Valitse työkirja

(Tämä ohjausobjekti näkyy vain valittaessa Microsoft Excel version 5.0, 7.0 tai 97 tietolähdettä.)

Tämä vaihtoehto näyttää Microsoft Excel 5.0-, 7.0- tai 97 -työkirjan. Määritä tietolähteeksi haluamasi työkirja valitsemalla Valitse työkirja -painike.

Ohjelma käsittelee työkirjaan kuuluvia laskentataulukoita järjestelmätaulukkoina (SYSTEM TABLE) ja laskentataulukoiden sisältämiä määritettyjä ja nimettyjä alueita taulukkoina (TABLE).


Näytä poistetut rivit

(Tämä ohjausobjekti näkyy vain käytettäessä dBASE-ohjainta)

Määrittää, voidaanko poistetuiksi merkityt rivit palauttaa tai voidaanko niihin siirtyä. Jos tätä vaihtoehtoa ei ole valittu, poistettuja rivejä ei näytetä; jos tämä vaihtoehto on valittu, poistettuja rivejä käsitellään samoin kuin poistamattomia rivejä. Oletusarvon mukaan vaihtoehtoa ei ole valittu.

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä DELETED-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Kieli

(Tämä vaihtoehto näkyy vain käytettäessä Microsoft Access-ohjainta.)

Asettaa tietokannan paikallistiedot (LCID). Valinta voi olla:

Yleinen (englanti, ranska, saksa, portugali, italia), espanja, hollanti, suomi/ruotsi, norja/tanska, islanti, tsekki, unkari, puola, venäjä, turkki, arabia, heprea, kreikka, japani, korea, kiina (perinteinen), kiina (yksinkertaistettu).

Tätä vaihtoehtoa ei voi asettaa suorituksen aikana kutsumalla SQLConfigDriver-funktiota.


Järjestelmätietokanta

(Tämä ohjausobjekti näkyy vain käytettäessä Microsoft Access -ohjainta.)

Määrittää Microsoft Access -tietokannan kanssa käytettävän Microsoft Access -järjestelmätietokannan täydellisen polunnimen.

Valitse käytettävä järjestelmätietokanta valitsemalla Järjestelmätietokanta-painike. ODBC Microsoft Access -ohjain kysyy käyttäjältä käyttäjätunnusta ja salasanaa. Oletustunnus on Admin ja sen oletussalasana on tyhjä merkkijono.

Voit parantaa Microsoft Access -tietokannan tietosuojausta luomalla uuden käyttäjätunnuksen Admin-tunnuksen tilalle ja poistamalla Admin-käyttäjätunnuksen. Voit myös muuttaa Admin-käyttäjän käyttöoikeuksia.

Valitse Ei mitään -valintanappi, jolloin kirjaudut Microsoft Access -tietokantaan Admin-käyttäjätunnuksella ilman järjestelmätietokannan käyttöä.

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä SYSTEMDB-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.

Lisätietoja järjestelmätietokannoista ja Admin-käyttäjätunnuksesta on Microsoft Accessin ohjeissa.


Säikeet

(Tämä ohjausobjekti näkyy vain käytettäessä Microsoft Access -ohjainta.)

Määrittää moduulin käyttämien taustasäikeiden määrän. Microsoft Access -ohjaimen oletusarvo on 3, mutta sitä voidaan muuttaa. Säikeiden määrää on ehkä syytä lisätä, jos tietokantaa käytetään paljon.

Tämä vaihtoehto on Microsoft Access -ohjaimen Määritä lisäasetukset -valintaikkunassa.

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä THREADS-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Käytä nykyistä kansiota

(Tämä ohjausobjekti näkyy vain käytettäessä dBASE-, Microsoft Excel-, Paradox- ja Teksti-ohjaimia.)

Kun tämä vaihtoehto on valittuna, sovelluksen nykyisestä työkansiosta tulee tietolähteen kansio ja Valitse kansio -painike himmennetään. Kun tämän vaihtoehdon valinta poistetaan, voit valita tietolähteen kansion Valitse kansio -painikkeen avulla.

Käytä nykyistä kansiota -ohjausobjekti on himmennetty valittaessa Microsoft Excel versioiden 5.0, 7.0 ja 97 tietolähdettä.


UserCommitSync

(Tämä ohjausobjekti näkyy vain käytettäessä Microsoft Access -ohjainta.)

Määrittää, suorittaako Microsoft Access -ohjain käyttäjän määrittämät tapahtumasarjat synkronisesti vai asynkronisesti. Oletusarvo on "Yes", mikä merkitsee, että Microsoft Access -ohjain odottaa, että käyttäjän määrittämä tapahtumasarja suoritetaan loppuun.

Tämän asetuksen muuttamisella arvoon "No" voi olla odottamattomia seurauksia monikäyttäjäympäristössä.

Tämä vaihtoehto on Microsoft Access -ohjaimen Määritä lisäasetukset -valintaikkunassa.

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä USERCOMMITSYNC-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Käyttäjätunnus

(Tämä ohjausobjekti näkyy vain käytettäessä Paradox-ohjainta.)

Määrittää Paradox-käyttäjätunnuksen, joka tulee muiden käyttäjien näyttöön heidän yrittäessään käyttää lukittua tiedostoa.

Voit määrittää tämän asetuksen suorituksen aikana käyttämällä PARADOXUSERNAME-avainsanaa kutsuessasi SQLConfigDataSource-funktiota.


Versio

Avattava luetteloruutu, jonka avulla voit valita käytettävien tiedostojen version, esimerkiksi tiedostoversiot dBASE III, dBASE IV tai dBASE 5.0, kun käytössä on dBASE-ohjain.

Microsoft Access -ohjainta käytettäessä voit valita tietokantamuodon, joka ilmaistaan version numerona. Jos valitset version 4.x, tietokannan salausasetus on käytettävissä.


Valitse tietokanta

Määritä sen aiemmin luodun Microsoft Access -tietokannan koko polku, jota haluat käyttää.


Luo tietokanta

Määritä luotavan Microsoft Access -tietokannan koko polku.


Tekstimuodon määrittäminen

Katso myös

Teksti-ohjainta käytettäessä voit Määritä tekstimuoto -valintaikkunassa määrittää valitun tiedoston esitysmuodon. Tässä valintaikkunassa voit määrittää kunkin tekstitiedoston rakenteen. Nämä tiedot on tallennettu tietolähteen kansiossa olevaan Schema.ini-tiedostoon. Ohjelma luo erillisen Schema.ini-tiedoston kuhunkin tekstitietolähteen kansioon.

Huomautus  Uusien tekstimuotoisten tietokantojen esitysmuoto määräytyy esitysmuodon oletusarvojen perusteella. Oletusarvot määritetään Määritä tekstimuoto -valintaikkunassa valitsemalla Taulukot-luettelosta vaihtoehto <oletus>. Teksti-ohjain ei muuta jo aiemmin luodun tekstitiedoston esitysmuotoa tässä valintaikkunassa määritettyä tekstimuotoa vastaavaksi, vaan palauttaa virheen, jos tekstitiedoston tiedot eivät vastaa määritettyä esitysmuotoa.

Ohjausobjekti	Tiedot
Lisää	Lisää sarakkeen käyttäen valintaikkunassa olevien Tietotyyppi-, Nimi- ja Leveys-ruutujen arvoja sekä tarpeen vaatiessa Schema.ini-tiedostossa määritettyä päivämääräerotinta.
Merkistö	ANSI tai OEM. OEM määrittää muun kuin ANSI-merkistön. Oletusarvo on OEM, jos Taulukot-luettelosta valitun kohteen esitysmuotoa ei ole aiemmin määritetty tässä valintaikkunassa.
Sarakenimitunniste	Osoittaa, käytetäänkö valitun taulukon ensimmäisen rivin sarakearvoja sarakkeiden niminä.. Oletusarvon mukaan vaihtoehtoa ei ole valittu, jos Taulukot-luettelosta valitun kohteen esitysmuotoa ei ole aiemmin määritetty tässä valintaikkunassa.
Sarakkeet	Sisältää valitun taulukon sarakkeiden nimien luettelon. Nimien järjestys on sama kuin sarakkeiden järjestys taulukossa. Tämä luettelo otetaan käyttöön, jos tiedosto on valittu Taulukot-luettelosta.
Tietotyyppi	Voi olla BIT, BYTE, CHAR, CURRENCY, DATE, FLOAT, INTEGER, LONGCHAR, SHORT tai SINGLE. Date-tietotyypin muoto voi olla jokin seuraavista: “pp-kkk-vv”, “kk-pp-vv”, “kkk-pp-vv”, “vvvv-kk-pp” tai “vvvv-kkk-pp”. “kk” tarkoittaa kuukauden numeroa ja “kkk” tarkoittaa sen kirjainlyhennettä.
Erotin	Määrittää oman sarakkeiden erotinmerkin. Ominaisuus on käytössä, kun esitysmuodoksi on valittu "Käyttäjän määrittämä erotin". Erotin voi olla vain yhden merkin pituinen, eikä lainausmerkkiä (") voi käyttää erotinmerkkinä. (Erotinta ei voi määrittää heksadesimaali- eikä desimaalimuodossa.)
Esitysmuoto	Määrittää joko erottimen käytön tai kiinteän pituuden. Erotinta käytettäessä osoittaa käytettävän erottimen: maakohtaisissa asetuksissa määritetty luetteloerotin (CSV), sarkain tai erikoismerkki (käyttäjän määrittämä). Oletusarvona on CSV-teksti, jos Taulukot-luettelosta valitun kohteen esitysmuotoa ei ole aiemmin määritetty tässä valintaikkunassa. Jos Sarakenimitunniste-valintaruutu on valittuna ja esitysmuodoksi on valittu kiinteä pituus, ensimmäisen rivin tietojen on oltava luetteloerottimella erotettuja.
Arvaa	Määrittää automaattisesti valitun taulukon sarakkeiden tietotyypin, nimen ja leveyden käymällä läpi taulukon sisällön Esitysmuoto-luetteloruudun valinnan mukaisesti. Toiminto on käytettävissä erotinta käyttävissä taulukoissa. Ohjelma poistaa sarakeluettelosta aiemmin määritetyt sarakkeet ja korvaa ne uusilla. Jos Sarakenimitunniste-valintaruutu ei ole valittuna, ohjelma antaa sarakkeille automaattisesti nimet "F1", "F2" jne. Tätä toimintoa voidaan käyttää vain sarakkeissa, jotka ovat kooltaan pienempiä kuin 64 513 tavua.
Muokkaa	Päivittää valitun sarakkeen tiedot käyttäen Tietotyyppi-, Nimi- ja Leveys-ruutujen arvoja.
Nimi	Näyttää valitun sarakkeen nimen. Voidaan käyttää uuden sarakkeen nimen määrittämiseen tai aiemmin luodun sarakkeen uudelleen nimeämiseen. Jos Sarakenimitunniste-valintaruutu on valittu, näytössä oleva sarakkeen nimi ohitetaan.
Poista	Poistaa valitun sarakkeen.
Läpikäytävät rivit	Rivien määrä, jonka valintaikkunan arvaustoiminto tai ohjain käy läpi määrittäessään taulukon arvojen perusteella sarakkeiden ominaisuudet. Voit määrittää tarkistettavien rivien määräksi luvun 1 - 32 767. Oletusarvo on 25, jos Taulukot-luettelosta valitun kohteen esitysmuotoa ei ole aiemmin määritetty tässä valintaikkunassa. (Sallittuun alueeseen kuulumaton arvo aiheuttaa virheen.)
Taulukot	Sisältää luettelon valitussa kansiossa olevista tiedostoista, joiden tunniste on tunnisteluettelon vaihtoehtojen mukainen. Kun vaihtoehto <oletus> on valittuna ja jokin alla olevista ehdoista toteutuu, Taulukot-ryhmän taulukkomääritteiden arvot kirjoitetaan Schema.ini-tiedostoon. Tiedoston muita tietoja ei muuteta. • Määritetyssä kansiossa ei ole Schema.ini-tiedostoa. • Schema.ini-tiedosto on olemassa, mutta siinä ei ole osaa jotain kansion sisältämää tekstitiedostoa varten. • Schema.ini-tiedostossa on osa tekstitiedostoa varten, mutta se on tyhjä. Kun vaihtoehto <oletus> on valittuna, ohjelma himmentää Sarakkeet-ryhmän.
Leveys	CHAR- tai LONGCHAR-sarakkeiden leveyttä voidaan muuttaa. Leveyden oletusarvo on 1, jos Taulukot-luettelosta valitun kohteen esitysmuotoa ei ole aiemmin määritetty tässä valintaikkunassa. Muiden tietotyyppien sarakkeiden leveyden ohjausobjekti on himmennetty, eikä leveyden arvoa näytetä.


Rakennetiedosto

Tietokannan rakennetiedosto (Schema.ini) sisältää tietoja kaikista tietolähteen taulukoista (tekstitiedostoista), muun muassa taulukon tietojen esitysmuodosta, saraketyypin määrittämiseksi läpikäytävien rivien määrästä, siitä, sisältääkö taulukon ensimmäinen rivi sarakkeiden nimet, onko lähdetiedosto kirjoitettu käyttämällä OEM- vai ANSI-koodisivua, sekä jokaisen sarakkeen nimen, tietotyypin ja leveyden.


Schema.ini tiedosto

Katso myös

Teksti-ohjainta käytettäessä tekstitiedoston esitysmuoto määräytyy rakennetiedoston tietojen perusteella. Rakennetiedosto, joka on aina nimeltään Schema.ini ja sijaitsee aina samassa kansiossa kuin tietolähde, antaa ISAM-moduulille tietoja tiedoston esitysmuodosta, sarakkeiden nimistä ja tietotyypistä sekä monista muista ominaisuuksista. Kiinteää pituutta käyttävien tietojen käsitteleminen edellyttää aina Schema.ini-tiedoston käyttöä; Schema.ini-tiedostoa kannattaa myös käyttää, kun tekstitaulukossa on DateTime-, Currency- tai Decimal-tietotyypin tietoja tai kun haluat hallita taulukon tietojen käsittelyä paremmin.

Huomautus Teksti-ohjaimen ISAM-moduuli saa oletusarvonsa rekisteristä, ei Schema.ini-tiedostosta. Uusien tekstimuotoisten tietokantojen esitysmuoto määräytyy esitysmuodon oletusarvojen perusteella. Oletusarvot määritetään Määritä tekstimuoto -valintaikkunassa valitsemalla Taulukot-luettelosta vaihtoehto <oletus>. Jos rekisterin arvot poikkeavat Schema.ini-tiedoston arvoista, tietojen käsittelyssä käytetään Schema.ini-arvoja.

Schema.ini tiedostojen tiedot

Schema.ini-tiedostot sisältävät rakennetietoja tekstitiedoston tietueista. Kukin Schema.ini-tiedoston merkintä määrittää jonkin seuraavista viidestä taulukon ominaisuudesta:

•	tekstitiedoston nimi

•	tiedoston esitysmuoto

•	kenttien nimet, leveydet ja tietotyypit

•	merkistö

•	tietotyyppien muunnokset.

Näitä ominaisuuksia kuvaillaan lähemmin seuraavissa kohdissa.

Tiedostonimen määrittäminen

Schema.ini-tiedoston ensimmäinen merkintä on aina tekstilähdetiedoston nimi hakasulkeissa. Seuraava esimerkki on Koe.txt-tiedoston merkintä:

[Koe.txt]

Tiedoston esitysmuodon määrittäminen

Schema.ini-tiedoston Format-asetus määrittää tekstitiedoston muodon. Teksti-ohjaimen ISAM-moduuli pystyy lukemaan useimpien erotinmerkkiä käyttävien tiedostojen esitysmuodon automaattisesti. Tiedostossa voi käyttää mitä tahansa yksittäistä merkkiä erottimena lainausmerkkiä (") lukuun ottamatta. Schema.ini-tiedoston Format-asetus korvaa Windowsin Rekisterin asetukset tiedostokohtaisesti. Seuraavassa taulukossa on lueteltu Format-asetuksen kelvolliset arvot:

lukon esitysmuoto:

Esitysmuodon määritys:	Taulukon esitysmuoto:	Schema.ini esitysmuotolause:
Sarkainerotin	Tiedoston kentät on erotettu sarkaimilla.	Format=TabDelimited
CSV-erotin	Tiedoston kentät on erotettu maakohtaisissa asetuksissa määritetyllä luetteloerottimella (CSV = Comma separated values).	Format=CSVDelimited
Käyttäjän määrittämä erotin	Tiedoston kentät on erotettu käyttäjän määrittämällä erotinmerkillä. Voit määrittää erotinmerkiksi minkä tahansa muun merkin paitsi lainausmerkin ("); myös välilyöntimerkki kelpaa.	Format=Delimited(mukautettu erotinmerkki) -TAI- Jos erotinta ei ole määritetty: Format=Delimited( )
Kiinteämittainen	Tiedoston kentät ovat kiinteämittaisia.	Format=FixedLength
Kenttien määrittäminen

Voit määrittää erotinmerkkiä käyttävän tekstitiedoston kenttien nimet jommallakummalla seuraavista tavoista:

•	Kirjoita kenttien nimet taulukon ensimmäiselle riville ja aseta ColNameHeader-asetuksen arvoksi True.

•	Määritä kullekin sarakkeelle oma numero sekä määritä sarakkeen nimi ja tietotyyppi.

Kiinteämittaisten taulukoiden kullekin sarakkeelle on määritettävä oma numero ja nimi, tietotyyppi ja leveys.

Huomautus  Schema.ini-tiedoston ColNameHeader-asetus korvaa Windowsin rekisterin FirstRowHasNames-asetuksen tiedostokohtaisesti.

Kenttien tietotyypit voidaan määrittää automaattisesti. Voit ilmoittaa sarakkeiden tietotyyppien määrittämiseksi tarkistettavien rivien määrän MaxScanRows-asetuksen avulla. Jos asetat MaxScanRows-asetuksen arvoksi 0, ohjelma käy koko tiedoston läpi. Schema.ini-tiedoston MaxScanRows-asetus korvaa Windowsin rekisterin asetuksen tiedostokohtaisesti.

Seuraava merkintä osoittaa, että Microsoft Jet käyttää taulukon ensimmäisen rivin tietoja kenttien nimien määrittämiseen ja tutkii koko tiedoston määrittäessään käytettyjä tietotyyppejä:

ColNameHeader=True

MaxScanRows=0

Seuraava Schema.ini-merkintä määrittää taulukon kentät käyttäen sarakenumero (Coln) -asetusta, joka on valinnainen käytettäessä eroteltuja taulukoita ja pakollinen käytettäessä kiinteämittaisia taulukoita. Esimerkissä näkyvät kahden eri kentän merkinnät, 10 merkin pituisen AsiakasNro-tekstikentän ja 30 merkin pituisen AsiakasNimi-tekstikentän, merkinnät

Col1=AsiakasNro Text Width 10

Col2=AsiakasNimi Text Width 30

Coln-syntaksi on seuraava:

Coln=Sarakenimi Tyyppi [Width #]

Seuraavassa on kuvattu Coln-asetuksen osat:

Parametri:	Kuvaus:
Sarakenimi	Sarakkeen nimi. Jos sarakkeen nimessä on välilyöntejä, se on erotettava lainausmerkeillä.
Tyyppi	Tietotyyppi voi olla jokin seuraavista: Microsoft Jet -tietotyypit: Bit Byte Short Long Currency Single Double DateTime Text Memo ODBC -tietotyypit: Char (sama kuin Text) Float (sama kuin Double) Integer (sama kuin Short) LongChar (sama kuin Memo) Date päivämäärän esitysmuoto
Width	Merkkijonoliteraali Width. Osoittaa, että sitä seuraava numero määrittää sarakkeen leveyden (valinnainen erotelluissa taulukoissa, pakollinen kiinteämittaisissa taulukoissa)..
#	Kokonaisluku, joka määrittää sarakkeen leveyden (tarvitaan, jos Width on määritetty).
Merkistön valitseminen

Voit valita joko ANSI- tai OEM-merkistön. Schema.ini-tiedoston CharacterSet-asetus korvaa Windowsin rekisterin asetuksen tiedostokohtaisesti. Alla oleva esimerkki on ANSI-merkistön käytettäväksi merkistöksi määrittävä Schema.ini-merkintä:

CharacterSet=ANSI

Tietotyyppien esitysmuotojen ja muuntamistapojen määrittäminen

Schema.ini-tiedostossa on joukko vaihtoehtoja, joiden avulla voit määrittää tietojen esitysmuodon ja tietotyyppien muuntamistavan. Nämä vaihtoehdot on kuvattu seuraavassa taulukossa:

Vaihtoehto:	Kuvaus:
DateTimeFormat	Määrittää päivämäärän ja kellonajan esitysmuodon merkkijonona. Tämä asetus kannattaa määrittää, jos tiedoston päivämäärät ja kellonajat poikkeavat Ohjauspaneelissa määritetyistä päivämäärän ja kellonajan esitysmuodoista. Kaikkia Microsoft Jet -esitysmuotoja paitsi muotoja A.M. ja P.M. tuetaan. Jos tätä merkkijonoa ei määritellä, ohjelma käyttää Ohjauspaneelissa määritettyä lyhyttä päivämäärän ja ajan muotoa.
DecimalSymbol	Voi olla mikä tahansa yksittäinen merkki, jota käytetään erottamaan luvussa kokonaisosa desimaaliosasta.
NumberDigits	Määrittää luvussa näytettävien desimaalien määrän.
NumberLeadingZeros	Määrittää, käytetäänkö desimaaliluvuissa välillä –1 ja 1 edeltävää nollaa. Arvo voi olla False (ei etunollaa) tai True.
CurrencySymbol	Määrittää tekstitiedostossa käytettävän valuuttasymbolin. Valuuttasymboli voi olla esimerkiksi markan symboli (mk).
CurrencyPosFormat	Voi olla jokin seuraavista:· • valuuttasymboli luvun edessä ilman väliä (mk1) • valuuttasymboli luvun jäljessä ilman väliä (1mk) • valuuttasymboli luvun edessä yhdellä välillä erotettuna (mk 1) • valuuttasymboli luvun jäljessä yhdellä välillä erotettuna (1 mk).
CurrencyDigits	Määrittää valuuttamäärän esityksessä käytettävien desimaalien määrän.
CurrencyNegFormat	Negatiivisen valuuttamäärän esitysmuoto voi olla jokin seuraavista:· • (mk1) • –  mk1 • mk–1 • mk1– • (1mk) • –  1mk • 1–mk • 1mk– • –  1 mk • –  mk 1 • 1 mk– • mk 1– • mk –1 • 1– mk • (mk 1) • (1 mk). Tässä esimerkissä on käytetty markan lyhennettä, mutta voit korvata sen haluamallasi CurrencySymbol-arvolla.
CurrencyThousandSymbol	Määrittää yksittäisen merkin, jota käytetään tekstitiedoston valuuttamäärän esityksessä tuhaterottimena.
CurrencyDecimalSymbol	Voi olla mikä tahansa yksittäinen merkki, jota käytetään valuuttamäärän esityksessä erottamaan luvun kokonaisosa desimaaliosasta.
Huomautus   Jos näitä asetuksia ei määritetä, ohjelma käyttää Ohjauspaneelissa määritettyjä asetuksia.


Tekstitiedoston muoto (laajennettu kielioppi)

Katso myös

ODBC Teksti-ohjain tukee sekä eroteltuja (erotinta käyttäviä) että kiinteämittaisia tekstitiedostoja. Tekstitiedosto koostuu valinnaisesta otsikkorivistä ja tekstiriveistä, joita voi olla 0 tai enemmän.

Vaikka otsikkorivin esitysmuoto on sama kuin muiden tekstitiedoston rivien, ODBC Teksti-ohjain tulkitsee otsikkorivin sarakkeen nimiksi eikä normaalitiedoiksi.

Erotellussa (erotinta käyttävässä) tekstirivissä on yksi tai useita arvoja. Arvot on eroteltu toisistaan erottimilla, joko luetteloerottimilla, sarkaimilla tai käyttäjän määrittämillä erottimilla. Tiedostossa voidaan käyttää vain yhtä erotinmerkkiä. Tyhjät tietoarvot ilmaistaan kahdella peräkkäisellä erottimella ilman välissä olevia merkkejä. Merkkijonot voidaan kirjoittaa lainausmerkkeihin (""). Määritettyjen arvojen jälkeen tai niitä ennen ei saa olla välilyöntejä.

Kiinteämittaisen tekstirivin tietojen leveys määritetään rakennetiedoissa. Tyhjät arvot ilmaistaan välilyönnein.

Taulukoiden enimmäiskoko on 255 kenttää sekä kenttänimien enimmäispituus on 64 merkkiä ja enimmäisleveys 32 766 merkkiä. Tietueiden enimmäiskoko on 65 000 tavua.

Tekstitiedoston voi avata vain yksi käyttäjä kerrallaan. Monen käyttäjän samanaikaista tiedoston käyttöä ei tueta.

Alla oleva ohjelmoijia varten kirjoitettu syntaksi määrittää tekstitiedoston muodon, jota ODBC Teksti-ohjain osaa tulkita. Kursivoimattomat kirjaimet osoittavat merkkejä, jotka on kirjoitettava näytetyssä muodossa, kursivoitu teksti ilmaisee argumentit, jotka on määritetty muualla syntaksissa, hakasulkeet ([]) ilmaisevat valinnaisia osia, aaltosulkeet ({}) ilmaisevat toisensa pois sulkevia vaihtoehtoja, pystyviivat (|) erottavat nämä vaihtoehdot toisistaan ja pisteet (...) ilmaisevat valintoja, jotka voidaan toistaa kerran tai useita kertoja.

Tekstitiedoston muoto on seuraava:

teksti-tiedosto ::=
[erotettu-otsikkorivi] [erotettu-tekstirivi]... tiedoston-loppu |
[kiinteämittainen-otsikkorivi] [kiinteämittainen-tekstirivi]... tiedoston-loppu

erotettu-otsikkorivi ::= erotettu-tekstirivi

erotettu-tekstirivi ::=
tyhjä-rivi |
erotettu-data [erotin erotettu-data]... rivin-loppu

kiinteämittainen-otsikkorivi ::= kiinteämittainen-tekstirivi
kiinteämittainen-tekstirivi ::=

tyhjä-rivi |
kiinteämittainen-data [kiinteämittainen-data]... rivin-loppu

tiedoston-loppu ::= <EOF>

tyhjä-rivi ::= rivin-loppu

erotettu-data ::= erotettu-merkkijono | luku | päivämäärä | erotettu-tyhjä

kiinteämittainen-data ::= kiinteämittainen-merkkijono | numero | päivämäärä | kiinteämittainen-tyhjä
Huomautus  Kiinteämittaisen tekstitiedoston sarakkeiden leveydet on määritetty Schema.ini-tiedostossa.

rivin-loppu ::= <CR> | <LF> | <CR><LF>

erotettu-merkkijono ::= merkkijono ilman lainausmerkkejä | lainausmerkein-varustettu-merkkijono

merkkijono ilman lainausmerkkejä ::= [merkki | numero] [merkki | numero | lainaus-merkki]...

lainausmerkein-varustettu-merkkijono ::=
lainaus-merkki
[merkki | numero | erotin | rivin-loppu | upotettu-lainausmerkein-varustettu-merkkijono]...
lainaus-merkki

upotettu-lainausmerkein-varustettu-merkkijono ::=
lainaus-merkki lainaus-merkki
[merkki | numero | erotin | rivin-loppu]
lainaus-merkki lainaus-merkki

kiinteämittainen-merkkijono ::= [merkki | numero | erotin | lainaus-merkki] ...

merkki ::=  mikä tahansa merkki paitsi:
erotin
numero
tiedoston-loppu
rivin-loppu
lainaus-merkki

numero ::= 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9

erotin ::= , | <SARKAIN> | oma-erotin

oma-erotin ::= mikä tahansa merkki paitsi:
tiedoston-loppu
rivin-loppu
lainaus-merkki
Huomautus  Käyttäjän määrittämää erotinta käyttävän tekstitiedoston erotin on määritetty Schema.ini-tiedostossa.

lainaus-merkki ::= "

luku ::= tarkka-lukuarvo | likiarvo

tarkka-lukuarvo ::= [+ | -] {etumerkitön-kokonaisluku[.etumerkitön-kokonaisluku] |
etumerkitön-kokonaisluku. |
..etumerkitön-kokonaisluku}

likiarvo ::= tarkka-lukuarvo{e | E}[+ | -]etumerkitön-kokonaisluku

etumerkitön-kokonaisluku ::= {numero}...

päivämäärä ::=
pp päivämäärä-erotin kk päivämäärä-erotin vv |
pp päivämäärä-erotin kkk päivämäärä-erotin vv |
pp päivämäärä-erotin kk päivämäärä-erotin vvvv |
pp päivämäärä-erotin kkk päivämäärä-erotin vvvv |

kk ::= numero [numero]

pp ::= numero [numero]

vv ::= numero numero

vvvv ::= numero numero numero numero

kkk ::= tammi | helmi | maalis | huhti | touko | kesä | heinäl | elo | syys | loka | marras | joulu

päivämäärä-erotin ::= - | / | .

erotettu-tyhjä ::=
Huomautus  Erotinta käyttävissä tiedostoissa NULL (tyhjä) ilmaistaan kahdella erottimella, joiden välissä on tyhjää.

kiinteämittainen-tyhjä ::= <VÄLILYÖNTI>...
Huomautus  Kiinteämittaisissa tiedostoissa NULL (tyhjä) ilmaistaan välilyönneillä.


Valitse avainkentät

Valitse yksi tai useita sarakkeita, joiden arvot yksilöivät kunkin tietueen.


Tietolähde

Kun käytät Microsoft Access -ohjainta, tietolähde määrittää sen Microsoft Access -tietokannan (.mdb), jota haluat käyttää, ja tiedot, joita tämän tietokannan noutaminen edellyttää.

Kun käytät dBASE, Microsoft Excel 3.0/4.0, Paradox tai Teksti-ohjainta, tietolähde määrittää oletuskansion, josta ODBC-ohjain hakee haluamiasi tiedostoja sekä muita tietoja.

Microsoft Excel 5.0, 7.0 tai 97 -ohjainta käytettäessä tietolähde määrittää oletustyökirjan, josta ODBC-ohjain hakee haluamiasi tiedostoja sekä muita tietoja


Salasana

Katso myös

Salasana on kirjoitettava yhteyttä muodostettaessa joko määrittäen salasana yhteysmerkkijonoon (Microsoft Access -sovelluksessa UID ja PWD, Paradox-sovelluksessa PWD) tai käyttäen SQLConnect -funktiota ja szAuthStr-argumenttia.

Kun käytetään Microsoft Access -ohjainta ja tietolähde käyttää järjestelmätietokantaa, sovellus saattaa kysyä käyttäjätunnusta ja salasanaa. Oletustunnus on Admin ja sen oletussalasana Microsoft Accessissa on tyhjä merkkijono.

Paradox-ohjainta käytettäessä salasanaa tuetaan vain, jos se kirjoitetaan yhteysmerkkijonoon. Tämä salasana kelpaa aina taulukkoa avattaessa. Jos yhteysmerkkijonoon ei kirjoiteta salasanaa, taulukolle ei määritetä salasanaa. Jos taulukoilla on eri salasanat, niitä ei voi avata samassa istunnossa eikä niitä voi liittää toisiinsa.


Heterogeeniset liitokset ja ulkoiset taulukot

Microsoft Access -ohjain tukee ulkoisia taulukoita ja heterogeenisia liitoksia.

Linkkien luomista ulkoisiin taulukoihin ei tueta. Microsoft Access -ohjainta ei tulisi käyttää ulkoisten taulukoiden liittämiseen Microsoft Access -tietokantaan. Ulkoiset taulukot tulisi liittää tietokantaan Microsoft Accessissa.

ODBC-tietokantaohjainten käyttöä DAO-koodissa (Data Access Objects) ei tueta.


Microsoft Excel -taulukoiden avaaminen

Microsoft Excel -ohjain ei pysty lukemaan versiota 3.0 aiemmalla Microsoft Excel -versiolla luotuja tiedostoja. Voit avata nämä tiedostot uudemmalla Microsoft Excel -versiolla ja tallentaa ne 3.0, 4.0, 5.0, 7.0 tai 97-muodossa, jolloin ohjain pystyy lukemaan niitä.

Jos yhteys muodostettiin tietolähteeseen, jonka versio on “Excel 3.0” tai “Excel 4.0”, tietolähteestä luodaan BIFF3-version taulukko. Jos tietolähde on “Excel 5.0”, “Excel 7.0” tai “Excel 97”, tietolähteenä käytettyyn työkirjaan luodaan laskentataulukko.

Microsoft Excel 3.0- ja Microsoft Excel 4.0 -tiedostomuodoissa täytyy määrittää tietokanta-alue. Microsoft Excel -ohjain tulkitsee nimetyt alueet taulukoiksi. Nimettyinä alueina määritetyt tietokannat kasvavat, kun uutta tietoa lisätään. Jos uutta tietoa kirjoittuu vanhan tiedon päälle laskentataulukossa (tietoja vastaavan nimetyn alueen ulkopuolelle), seurauksena on virhe.

Kaikki luodut ja tietojen lisäämistä varten avatut Microsoft Excel -taulukot (laskentataulukot) avataan oletusarvon mukaan yksityiskäyttöön, eli vain yksi käyttäjä kerrallaan voi avata ne. Käyttäjän on määritettävä erikseen, kun hän haluaa jakaa Microsoft Excel -taulukoita. Vaihtoehdolla "Vain luku" useat käyttäjät voivat samanaikaisesti katsoa .xls-tiedostoja..


Salasanalla suojatut tiedostot

Paradox-ohjainta käytettäessä ohjelma varaa salasanalla suojatun tiedoston käyttäjälle, joka sen on avannut. Tällöin muut käyttäjät eivät voi käyttää tiedostoa.


Yhteyden epäonnistuminen useiden yhteydenmuodostamisten jälkeen

Jos Microsoft Windows 95/98 -käyttöjärjestelmässä toimiva ODBC-sovellus muodostaa ja katkaisee yhteyden palvelimeen toistuvasti (yli 50 - 60 kertaa), voi tapahtua yhteysvirhe, jolloin ohjain palauttaa SQLSTATE 01000 -virhekoodin (Yleinen varoitus) ja näyttää virhesanoman “Lausekepalvelun lataaminen epäonnistui”. Tämä voi olla ongelma etenkin Web -palvelinsovelluksia käytettäessä. Voit poistaa ongelman päivittämällä Windowsin Järjestelmäkansiossa olevan Rpcrt4.dll-tiedoston QFE 324-version mukaiseksi. Saat lisätietoja ottamalla yhteyden Microsoftin tuotetukeen.


Viite-eheys

Ohjelma tukee viite-eheyttä vain Microsoft Access -tietolähteille ja vain jos viite-eheys on määritetty tietolähteeseen Microsoft Accessissa.


Lotus 1-2-3- ja EMS-tiedot

ODBC-tietokantaohjaimet eivät tue Lotus 1-2-3- tai EMS-tietojen käsittelemistä.


Visual Basic -käytettävyys

Visual Basicin TableDef-objektin Connect- ja Attributes-ominaisuuksien avulla voidaan käyttää ODBC-tietokantaohjaimia ja muodostaa niiden välityksellä yhteys ODBC-tietokantaan. Lisätietoja on Visual Basicin ohjeissa.


Yhteysmerkkijonot (laajennettu kielioppi)

Katso myös

ODBC-ohjainten yhteysmerkkijonossa käytetään seuraavia avainsanoja:

Avainsana:	Kuvaus:
DSN	Tietolähteen nimi
DBQ	Kansion nimi
DRIVERID	Ohjaimen tunnusluku
FIL	Tiedostotyyppi (MS Access käytettäessä Microsoft Accessia; dBASE III, dBASE IV tai dBASE5; Excel 3.0, Excel 4.0, Excel 5.0, Excel 7.0 tai Excel 97 Microsoft Exceliä käytettäessä; Paradox 3.x, 4.x tai 5.x; Teksti) Tätä avainsanaa tuetaan vain yhteensopivuussyistä vanhempien versioiden tukemiseksi..
Ohjainkohtaiset avainsanat

Yllä olevassa taulukossa lueteltujen avainsanojen lisäksi Microsoft Access -ohjain käyttää UID- ja PWD-avainsanoja sekä Paradox-ohjain käyttää PWD-avainsanaa.

Avainsana:	Kuvaus:
UID	Käyttäjätunnus (vain Microsoft Accessissa). Oletustunnus on “Admin”. Lisätietoja Admin-käyttäjätunnuksesta on Microsoft Jet Database Engine Programmer’s Guide -oppaan luvun 10 “Managing Security” kohdassa “Creating a New Admin User”.
PWD	Käyttäjän määrittämä salasana.
Yllä kuvattujen avainsanojen lisäksi yhteysmerkkijonoissa tuetaan muidenkin avainsanojen käyttöä. Lisätietoja näistä avainsanoista on ohjeaiheessa SQLConfigDataSource. Yhteysmerkkijonoissa ei tueta Microsoft Access -kohtaisia avainsanoja, joita käytetään tietokannan uudelleenjärjestämiseen (COMPACT_DB) ja sen luomiseen (CREATE_DB).

Käytettäessä Microsoft Access- tai Paradox-ohjainta PWD-avainsanassa ei saa olla erikoismerkkejä (katso kohtaa SQL_SPECIAL_CHARACTERS ohjeaiheessa SQLGetInfo Returned Values).

Yhteysmerkkijonoja käytetään myös, kun Microsoft Access -tietokanta liitetään ohjelmointikoodissa käyttämällä SQLConfigDriver-funktiota. Käytä syntaksia "JET_ATTACH <lähdetietokanta> <yhteysmerkkijono>") SQLConfigDriver-funktion argumenttiluettelossa (lpszArgs. Tässä funktiossa <lähdetietokanta> on sen Microsoft Access -tietokannan koko polku, joka liitetään ja <yhteysmerkkijono> noudattaa tässä luvussa esitettyjä käytäntöjä.

Huomautus   Yhteysmerkkijonojen, joilla muodostetaan yhteys tietokantaan käyttämällä Jet 4.0:aa tai uudempaa tietokantamoduulia, tulisi määrittää paikallistieto yksittäisen LCID-tunnuksen avulla erillisten CodePage- ja LangID-määritysten sijasta.


Valitse tietokanta -valintaikkuna (laajennettu kielioppi)

Microsoft Access -ohjainta käytettäessä voidaan valita aiemmin luotu tietokanta valitsemalla Microsoft Access Asennus -valintaikkunassa Valitse-painike.

Valitse tietokanta -valintaikkunassa ovat seuraavat ohjausobjektit:

Ohjaus-objekt:	Kuvaus:
Tietokannan  nimi	Aiemmin luodun tietokannan nimi (tunniste on .mdb)
Yksityinen	Jos Yksityinen-ruutu on valittu, ohjelma avaa tietokannan yksityiskäyttöön, jolloin tietokantaa ei voi käyttää kuin yksi käyttäjä kerrallaan. Jos Yksityinen-ruudun valinta poistetaan, ohjelma avaa tietokannan jaetussa tilassa, jolloin sitä voi käyttää useita käyttäjiä samanaikaisesti. Ohjaimen suorituskyky on parempi käytettäessä yksityiskäyttötilaa.
Vain luku	Määrittää tietokannan vain luku -tietokannaksi.


Luo tietokanta -valintaikkuna (laajennettu kielioppi)

Microsoft Access -ohjainta käytettäessä voidaan luoda uusi tietokanta valitsemalla Microsoft Access Aennus -valintaikkunassa Luo-painike.

Huomautus   Luo-painikkeen avulla luotu tietokanta toimii vain Microsoft Access versiossa 7.0 tai uudemmassa.

Uusi tietokanta -valintaikkunassa ovat seuraavat ohjausobjektit:

Ohjaus-objekti:	Kuvaus:
Tietokannan nimi	Tietokantatiedoston nimi (tunniste on .mdb).
Esitysmuoto	Microsoft Jet-tietokantamoduulin esitysmuoto. Tämä voi olla: Versio 4.x (uusin, Unicode-muoto), Versio 3.x (ANSI-muoto) tai Versio 2.x (ANSI-muoto).
Kieli	Määrittää LCID:n paikallistunnuksen. Korvaa aiemman Lajittelujärjestys-ohjausobjektin, mutta useimmat oletuslajittelujärjestyssäännöt ovat voimassa. Tämä voi olla:  Yleinen (englanti, ranska, saksa, portugali, italia), espanja, hollanti, suomi/ruotsi, norja/tanska, islanti, tsekki, unkari, puola, venäjä, turkki, arabia, heprea, kreikka, japani, korea, kiina (perinteinen), kiina (yksinkertaistettu)..
Asetukset	Järjestelmätietokanta: Luo järjestelmätietokannan. Salaus: Microsoft Jet Engine 4.0 tukee tietokannan tietojen salausta.
Tietokannan luominen SQLConfigDriver-funktiolla

Kun haluat luoda tietokannan ohjelmallisesti käyttämällä SQLConfigDriver-funktiota, käytä merkkijonoa "CREATE_DB=<polunnimi><valinnainen lajittelujärjestys><valinnainen_ENCRYPT avainsana>" SQLConfigDriver-funktion argumenttiluettelona (lpszArgs). Tässä merkkijonossa <polunnimi> on luotavan Microsoft Access -tietokannan täydellinen polunnimi, valinnainen lajittelujärjestys jokin yllämainituista kielistä ja valinnainen ENCRYPT-avainsana, joka määrittää tietokannan tiedot suojattaviksi.


Tietokannan korjaaminen (laajennettu kielioppi)

Kun Microsoft Access -ohjainta käytettäessä tapahtumasarjan suorittamisen aikana (SQLTransact-funktion jälkeen mutta ennen funktion suorittamista loppuun) tapahtuu asiakassovelluksen virhe, tietokanta saattaa vioittua niin, että se on korjattava. Korjauksen voi tehdä joko Microsoft Access -ohjaimen Asennus-valintaikkunan avulla tai ohjelmallisesti käyttämällä SQLConfigDataSource-funktiota. Jet Enginen versiosta 4.0 lähtien korjaustoiminto on sisältynyt uudelleenjärjestämistoimintoon. Yhteensopivuuden varmistamiseksi aikaisempien versioiden kanssa Desktop Database -ohjaimet ohjaavat Korjaa-komennon Järjestä uudelleen -komentoon.

Microsoft Access -ohjaimen asennusvalintaikkunan käyttäminen

Voit korjata tietokannan Microsoft Access -ohjaimen asennusvalintaikkunassa valitsemalla Korjaa-painikkeen. Valitse tiedosto ja polku ja sen jälkeen OK.

SQLConfigDataSource-funktion käyttäminen

Voit korjata tietokannan ohjelmallisesti käyttämällä merkkijonoa "REPAIR_DB=<polunnimi>" SQLConfigDataSource-funktion määriteluettelona (lpszAttributes). Funktiossa <polunnimi> on Microsoft Access -tietokannan täydellinen polunnimi.

Salasanalla suojattua tiedostoa korjattaessa käyttäjätunnus ja salasana on kirjoitettava Määritä lisäasetukset -valintaikkunaan (tai ohjelmallisesti SQLConfigDataSource-funktion määriteluetteloon). Salasana ja käyttäjätunnus on poistettava korjauksen jälkeen.

SQLConfigDriver-funktion käyttäminen

Kun haluat tehdä korjauksia tietokantatiedostoon ohjelmallisesti käyttämällä SQLConfigDriver-funktiota, käytä  SQLConfigDriver-funktion argumenttiluettelona (lpszArgs). ) merkkijonoa "REPAIR_DB=<path_name>”. Tässä merkkijonossa <polunnimi> on korjattavan Microsoft Access -tietokannan täydellinen polunnimi.

Nämä toiminnot suorittavat normaalin Microsoft Access -tietokannan korjaustoiminnon ja saattavat muuttaa Microsoft Access -tietokantojen tietoja.

Muista, että vialliseksi ilmoitettu tietokanta saattaa kuitenkin olla kunnossa. Ilmoituksen saattaa aiheuttaa virhe tietokannan sulkemisessa, jolloin tietyt tietokannan eheyttä ilmaisevat tiedot eivät päivity oikein. Tällöin saattaa olla tarpeen estää tietokannan virhesanoman näkyminen käyttäjälle. Tämä voidaan tehdä kutsumalla SQLDriverConnect-funktiota ja käyttämällä argumenttia SQL_DRIVER_NOPROMPT.

Lisätietoja Microsoft Access -tietokantojen korjaamisesta on Microsoft Accessin Ohjeessa.


Tietokannan uudelleenjärjestäminen
Tietokannan uudelleenjärjestäminen (laajennettu kielioppi)

Käytettäessä Microsoft Access-ohjainta tietokantatiedoston tiedot voidaan järjestää uudelleen kolmella menetelmällä: asennuksen yhteydessä Microsoft Access -ohjaimen asennusvalintaikkunassa tai ohjelmallisesti käyttämällä joko SQLConfigDataSource-funktiota tai SQLConfigDriver-funktiota. Microsoft Access -tietokannat tulisi järjestettää uudelleen säännöllisesti.

Microsoft Access -ohjaimen asennusvalintaikkunan käyttäminen

Voit järjestää tietokantatiedoston uudelleen Microsoft Access -ohjaimen asennusvalintaikkunassa valitsemalla Järjestä-painikkeen. Valitse Tietokannan uudelleenjärjestäminen: kohdetietokanta -valintaikkunassa tiedosto, polku, uudelleen järjestetyn tiedoston versio ja kieli (joka voidaan vaihtaa) ja valitse OK. Uudelleenjärjestämisen kohdetiedosto voi olla sama kuin lähdetiedosto. Jos uudelleenjärjestämisen kohdetiedoston niminen tiedosto (muu kuin lähdetiedosto) on jo olemassa, aiheutuu virhe.

SQLConfigDriver-funktion käyttäminen

Voit järjestää tietokantatiedoston uudelleen ohjelmallisesti käyttämällä merkkijonoa "COMPACT_DB=<lähdetk> <kohdetk> <lajittelujärjestys>" SQLConfigDataSource-funktion määriteluettelona (lpszAttributes). Funktiossa <lähdetk> on uudelleenjärjestettävän Microsoft Access -tietokannan täydellinen polunnimi ja <kohdetk> uudelleenjärjestetyn Microsoft Access -tietokannan täydellinen polunnimi.

Salasanalla suojattua tiedostoa uudelleenjärjestettäessä käyttäjätunnus ja salasana on kirjoitettava Määritä lisäasetukset -valintaikkunaan (tai ohjelmallisesti SQLConfigDataSource-funktion määriteluetteloon). Salasana ja käyttäjätunnus on poistettava uudelleenjärjestämisen jälkeen. Salasanalla suojattujen tiedostojen uudelleenjärjestämisellä voi olla odottamattomia seurauksia.

SQLConfigDriver-funktion käyttäminen

Kun haluat järjestää tietokannan ohjelmallisesti käyttämällä SQLConfigDriver-funktiota, käytä merkkijonoa "COMPACT_DB=<polunnimi><valinnainen lajittelujärjestys><valinnainen ENCRYPT avainsana>" SQLConfigDriver-funktion argumenttiluettelona (lpszArgs). Tässä merkkijonossa <polunnimi> on uudelleen järjestettävän Microsoft Access -tietokannan täydellinen polunnimi.

Nämä toiminnot suorittavat normaalin Microsoft Access -tietokantojen uudelleenjärjestämistoiminnon.

Lisätietoja Microsoft Access -tietokantojen uudelleenjärjestämisestä on Microsoft Accessin Ohjeessa.